Publish or schedule a post
publishPublishes a post to Threads now (publish_now:true) or at publish_at (ISO 8601 with offset). Takes text, one public https image (media_urls with 1 url), a carousel (2 to 10 urls) or a video_url. Text over 500 characters is split into a thread. Publishing now or within 30 minutes uses the publish-now permission; a post 30 minutes or more ahead uses the schedule permission. Either may wait for the owner's confirmation when that permission is set to ask on this connection. publish_at takes any offset and comes back in UTC (Z); a publish_at more than 60 seconds in the past returns 400 publish_at_in_past with server_now. The same account needs at least 10 minutes between scheduled posts: a closer publish_at returns 400 schedule_too_dense with nearest_publish_at. idempotency_key makes a retried request return the first result instead of posting twice. Applies when the user has final text and wants it on Threads.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account_id": "<account_id>"
},
"name": "publish"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Post text / caption | |
| video_url | No | Public https MP4/MOV | |
| account_id | Yes | Account id | |
| media_urls | No | Public https image URLs (1 = image, 2-10 = carousel) | |
| publish_at | No | ISO 8601 if not publish_now | |
| publish_now | No | Publish immediately | |
| idempotency_key | No | Optional |