Create a post

Creates a post. Omit publishNow and scheduledAt to save a draft, set scheduledAt to schedule, or set publishNow to publish right away.

Category: Posts
Calls: POST/v1/posts
Safe to auto-approve: No. It changes data, so keep a human in the loop or scope the key.

Parameters

profileIdstringoptional

Profile to act on. Omit to use the profile this API key belongs to. Call list_profiles first when managing several customers.

contentstringoptional

Post text or caption.

object[]optional

Images or a video. Upload with upload_media first.

accountIdsstring[]optional

Account `id` values from list_accounts.

scheduledAtstringoptional

ISO 8601 datetime to publish at, for example 2026-08-01T12:00:00Z.

publishNowbooleanoptional

Publish immediately. Omit together with scheduledAt to save a draft.

platformsobjectoptional

Per-platform options keyed by platform name.

A tool call as an MCP client would send it.

{
  "name": "create_post",
  "arguments": {
    "content": "Shipping today.",
    "accountIds": [
      "string"
    ]
  }
}