Made for

Social Media API for Developers: REST, Webhooks and MCP

Updated October 27, 2026 · Multi Post Social guide

REST API overview

The base URL is /v1 on the API host shown in your workspace settings. Resources mirror the product: channels, posts, media, ideas, inbox, analytics, streams and webhooks. Every list endpoint supports cursor pagination, filtering by status and date, and sparse field selection. Times are ISO 8601 in UTC; the API returns the channel time zone alongside any scheduled time so you can display it correctly.

Authentication with API keys

Create a key in Settings → API keys. Keys are scoped to one workspace and one of three scopes: read, write or admin. The full key is shown once; afterwards only the prefix is visible, so store it in your secret manager at creation time. Send it as a bearer token. Rotate a key by creating a new one, switching your integration, then revoking the old one; both work during the overlap. Keys never grant access to the network tokens themselves.

Example: create a post for two channels

One request creates a post group: a base text, an optional variant per channel, media with alt text, a schedule mode (queue, at with a timestamp, now or draft) and tags.

POST /v1/posts
Authorization: Bearer mps_live_7f3a...
Content-Type: application/json

{
  "channel_ids": ["ch_8k2v", "ch_1m9q"],
  "text": "Three small changes that made our Monday planning shorter.",
  "variants": { "ch_1m9q": { "text": "Three changes that shortened our Monday planning." } },
  "media": [{ "url": "https://example.com/planning.png", "alt": "A weekly planning board" }],
  "schedule": { "mode": "queue" },
  "tags": ["Tips"]
}

HTTP/1.1 201 Created

{
  "group_id": "grp_c4t8",
  "posts": [
    { "id": "post_x1", "channel_id": "ch_8k2v", "status": "queued", "scheduled_at": "2026-11-03T09:00:00Z" },
    { "id": "post_x2", "channel_id": "ch_1m9q", "status": "queued", "scheduled_at": "2026-11-03T09:00:00Z" }
  ]
}

Validation errors come back as 422 with a list of problems per channel, such as a caption over the X limit or an image ratio Pinterest rejects. The same checks run in the composer, so the API and the app always agree.

Webhooks

Register an HTTPS endpoint and choose events. Each delivery is signed with an HMAC header you verify with the webhook secret; deliveries retry with backoff for 24 hours and you can replay any event from Settings.

Rate limits per plan

Limits apply per workspace and reset on a rolling window. Every response carries X-RateLimit-Remaining and X-RateLimit-Reset headers; a 429 includes Retry-After.

Burst limits of 100 requests per 15 minutes apply on every plan. See the pricing page for the rest of each plan.

MCP server for AI agents

The Model Context Protocol server exposes the API as tools an agent such as Claude or ChatGPT can call: read performance for a date range, list upcoming posts, draft a week of posts, add drafts to a workspace, reply to inbox items as drafts, and summarize a listening stream. Two rules are fixed. First, the server uses your API key's scope, so a read key can never write. Second, anything an agent creates lands as a draft or in Needs approval; a person approves in the app before it publishes. The integrations guide shows how to connect an agent in a few minutes, and the AI assistant guide explains how the in-app assistant differs from an external agent.