# schedule_post

> Page: https://docs.flung.dev/mcp/tools/schedule-post. Index of every page: https://docs.flung.dev/llms.txt

Schedule a post. Schedules one post to one or more accounts, now or at publishAt, and returns it with a target per account. Get account ids from list_accounts first. Pass the same idempotencyKey when retrying, or the post may go out twice. list_platforms says which need media.

## TL;DR

| Question | Answer |
|---|---|
| What does it do? | Schedules one post to one or more accounts, now or at publishAt, and returns it with a target per account. Get account ids from list_accounts first. Pass the same idempotencyKey when retrying, or the post may go out twice. list_platforms says which need media. |
| Does it change anything? | Changes something. |
| Which endpoint does it call? | [`POST /v1/posts`](https://docs.flung.dev/reference/api/post-v1-posts.md) |
| Which server? | `https://mcp.flung.dev/mcp-oauth` (sign in) or `https://mcp.flung.dev/mcp` (API key). |

## Arguments

| Argument | Type | Required | Description |
|---|---|---|---|
| `content` | `string` | yes | The text, within each platform's limit. at least 1 character; at most 10000 characters. |
| `accountIds` | `string[]` | yes | The accounts to post to. |
| `mediaIds` | `string[]` | no | Files from import_media, in order. |
| `publishAt` | `string` | no | ISO 8601 with offset; omit for now. See suggest_posting_times. pattern `^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z\|([+-](?:[01]\d\|2[0-3]):[0-5]\d)))$`. |
| `platformOverrides` | `object` | no | Per platform: other text, a Pinterest board, or the TikTok audience. |
| `idempotencyKey` | `string` | no | Any unique string; reuse it when retrying so the post is scheduled once. at least 1 character; at most 255 characters. |

## Example call

```json
{
  "name": "schedule_post",
  "arguments": {
    "content": "We are live. #launch",
    "accountIds": [
      "acct_aaaaaaaaaaaaaaaaaaaaaaaa"
    ],
    "publishAt": "2026-11-02T09:00:00+10:00"
  }
}
```

## Things a person might say

- "Post "We are live" to LinkedIn and X tomorrow at 9am."
- "Schedule this announcement for Monday."

## Annotations

| Hint | Value |
|---|---|
| `readOnlyHint` | false |
| `destructiveHint` | false |
| `idempotentHint` | false |
| `openWorldHint` | true |

## See also

| Doc | Why |
|---|---|
| [MCP tools](https://docs.flung.dev/mcp/tools.md) | Every tool |
| [Connect an AI agent](https://docs.flung.dev/mcp.md) | Install the server in your client |
| [`POST /v1/posts`](https://docs.flung.dev/reference/api/post-v1-posts.md) | The same operation over HTTP |