Tool reference/scheduling

SCHEDULING

schedule_post

Schedule an existing approved post to connected accounts. Requires browser approval. TikTok must be reviewed and submitted in the Caroush composer; this tool never supplies TikTok consent.

Mutationpublish:schedulesBrowser approval
Take the docs with youMarkdown for your editor or agent.
Download guide
TransportStreamable HTTP
Methodtools/call
ExecutionImmediate handler

Every new action requires a UUID idempotency_key. Reuse the same key and arguments for retries. The user reviews and approves this exact action in Caroush before it runs. Read the approval flow.

Request contract

Input parameters

post_idintegerrequired
captionstring
timezonestring
destinationsarrayrequired
idempotency_keystringrequired

A new UUID per intended action. Reuse exactly for retries; never reuse with different arguments.

Exact JSON schemas

These are the schemas exported by the Caroush MCP server.

Input schema · JSON
{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "integer",
      "minimum": 1
    },
    "caption": {
      "type": "string",
      "maxLength": 3000
    },
    "timezone": {
      "type": "string"
    },
    "destinations": {
      "type": "array",
      "minItems": 1,
      "maxItems": 12,
      "items": {
        "type": "object",
        "properties": {
          "social_account_id": {
            "type": "integer",
            "minimum": 1
          },
          "scheduled_at": {
            "type": "string",
            "format": "date-time"
          },
          "caption": {
            "type": "string",
            "maxLength": 3000
          }
        },
        "required": [
          "social_account_id",
          "scheduled_at"
        ],
        "additionalProperties": false
      }
    },
    "idempotency_key": {
      "type": "string",
      "format": "uuid",
      "description": "A new UUID per intended action. Reuse exactly for retries; never reuse with different arguments."
    }
  },
  "required": [
    "post_id",
    "destinations",
    "idempotency_key"
  ],
  "additionalProperties": false
}

Read the actual outcome

A successful handler response does not necessarily mean generation or publication is finished. Follow the returned operation, native run or schedule status. Results and job states

Back to all 49 tools