Instructions for programs
How an assistant or your own program hands posts to Sentworth.
1. Pick your way in
2. Connect
https://sentworth.com/mcpCopies these instructions as plain text, to paste into your assistant.
3. Hand over a post
curl https://sentworth.com/v1/posts \
-H "Authorization: Bearer sw_live_your_key" \
-H "Content-Type: application/json" \
-d '{"account_ids":["id_from_list_accounts"],
"text":"Kiln opening this Saturday, 11 to 4.",
"time":"2026-11-23T09:20:00+04:00",
"reference":"kiln-open-saturday"}'The eight actions
| Name | What it does | Request |
|---|---|---|
list_accounts | Your accounts and their ids. | GET /v1/accounts |
create_post | Hand over a post. | POST /v1/posts |
get_post | One post and its answer per account. | GET /v1/posts/{id} |
list_posts | Posts by state or date. | GET /v1/posts |
create_upload_link | A link to upload a picture or video. | POST /v1/uploads |
cancel_post | Cancel a scheduled post. | DELETE /v1/posts/{id} |
update_post | Change a scheduled post. | PATCH /v1/posts/{id} |
network_rules | Each network’s limits. | GET /v1/networks/{network}/rules |
list_accountsGET /v1/accountsYour accounts and their ids.create_postPOST /v1/postsHand over a post.get_postGET /v1/posts/{id}One post and its answer per account.list_postsGET /v1/postsPosts by state or date.create_upload_linkPOST /v1/uploadsA link to upload a picture or video.cancel_postDELETE /v1/posts/{id}Cancel a scheduled post.update_postPATCH /v1/posts/{id}Change a scheduled post.network_rulesGET /v1/networks/{network}/rulesEach network’s limits.
Rules
- A hand-over is refused whole if any network would refuse it. The answer names the limit and the figure, for example “X allows 280 characters; this has 312”.
- The same hand-over sent twice with the same
referenceposts once. - Posts go straight out, unless “Approve before posting” is on for that account.
- A TikTok or YouTube choice left out takes its default: Everyone (Only me until TikTok’s audit), and Not for kids.
- Assistants can’t connect accounts or touch billing.
4. Hear back
Call-back address
Give us one https address in Assistants and programs. We send it a signed message when:
- A post finishes, in any state
- An account needs reconnecting
- The day-50 warning before an account’s sign-in runs out
If your address does not answer, we try again for 24 hours, then email you.
Limits
- 400 posts an hour and 100 in 5 minutes, per login.
- 10 requests a second, per key or assistant.
- Every answer says what is left.
Hand-overs not arriving? See Status.