Publishum
EN
Sign inPublish my first postStart

API & MCP

API and MCP docs

Create a key in Dashboard > API, then publish a post to every account with one call. Keys start with pt_live_. Limit: 60 requests per minute.

1. Publish now

curl -X POST https://api.publishum.com/v1/posts \
  -H "Authorization: Bearer pt_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"texto": "Publishum launched today. Post to every network at once. Link in bio.", "contas": "todas"}'

2. Schedule with per-network text and media

{
  "texto": "Publishum launched today. Post to every network at once. Link in bio.",
  "por_rede": {
    "x": {
      "texto": "Publishum launched today. Post to every network at once. Link in bio.",
      "primeira_resposta": "https://publishum.com"
    },
    "linkedin": {
      "texto": "Three mistakes I made hiring my first employee, and what I would do differently today. Full thread in the comments."
    }
  },
  "contas": [
    "acc_x",
    "acc_th",
    "acc_bs",
    "acc_li"
  ],
  "midia": [
    {
      "id": "med_8f2k1",
      "alt": "Publishum"
    }
  ],
  "agendar_para": "2026-10-13T09:00:00-03:00"
}

3. Connect Claude through MCP

claude mcp add --transport http publishum https://api.publishum.com/mcp

Routes

RouteWhat it does
POST /v1/postsCreates, schedules or publishes a post
GET /v1/postsLists posts with status and account filters
GET /v1/posts/{id}Details with results per network
PATCH /v1/posts/{id}Edits a scheduled post or draft
DELETE /v1/posts/{id}Deletes a scheduled post or draft
GET /v1/contasConnected accounts and token expiry
POST /v1/midiaReturns a signed upload URL

Limits and errors

Link posts on X count against the plan quota (10 on Solo, 50 on Creator, 150 on Studio). The API returns a 402 with a message when the quota is used up.

MCP tools