Skip to main content

Posts, media, and first comments

Use POST /v1/rest/posts to create a post. Set isScheduled: true and a future dateTime to schedule it. Omitting isScheduled publishes immediately.

Images and video​

Send imageUrls or videoUrls as arrays of public, direct file URLs. A YouTube watch page or a Google Drive preview page is not a direct video file.

For an image post, add this field to the quickstart request:

{"imageUrls": ["https://example.com/your-image.jpg"]}

Replace that example URL with an actual image you control. The media still needs to satisfy the target platform's publishing requirements.

POST /posts currently ignores channelOptions. Do not use that field to select collaborators, YouTube settings, or platform-specific Reel settings on this route. PATCH /posts/{postId} and entries in POST /posts/bulk do accept channelOptions; see their schemas in the reference.

The REST API does not currently expose a Media Library upload or URL-import endpoint. coverMediaId is rejected by REST create, update, and bulk scheduling. Hosted MCP has a separate media upload flow.

Add a first comment when creating a post​

Include a shared firstComment object in POST /posts, or on each entry in POST /posts/bulk:

{
  "firstComment": {
    "text": "Find the details in our profile.",
    "delayMinutes": 5
  }
}

When creating a post, you can supply this field for Instagram, LinkedIn, Facebook Pages, YouTube, TikTok, and X. X uses a reply to the post. Delivery still depends on the platform, connection permissions, and publishing validation. This REST field is ignored for other platforms.

An optional media URL is supported for LinkedIn and Facebook only. Platform-specific comment limits apply. The older instaFirstComment string is retained for compatibility; use firstComment.text for new integrations.

Bulk scheduling and updates​

  • POST /posts/bulk accepts up to 100 entries. Partial success is possible; it is not an all-or-nothing transaction.
  • PATCH /posts/{postId} uses channelIds, not a singular channelId override.
  • Posts with IDs beginning live_ are read-only. See posts published outside Social Champ.
  • Always inspect results before retrying.
Last updated on