Round Robin Social
Log inStart free

Round Robin Social API

Scripts and assistants can do what you do in the app, and nothing more: a key acts as the person who made it, in the workspace it was made in, with their role and permissions there.

Keys

Make a key under Workspace settings, Developers. Name it after what will use it, pick what it may do, and copy it: it is shown once. Revoke it there when it's no longer needed.

A key works only in the workspace it was made in, with your role there now. If your role changes, so does what the key can reach; if you leave the workspace, it reaches nothing.

  • read: brands, accounts, posts, calendar, library, inbox and reports.
  • drafts: upload media, create, edit and delete drafts.
  • schedule: schedule a draft, add it to the queue, delete a scheduled post.
  • reply: reply in the inbox.

Send it on every request. Each key may make 120 requests a minute; past that the answer is 429 with Retry-After.

curl -H "Authorization: Bearer rrs_..." https://social.roundrobin.in/api/v1/brands

The API never posts straight away: a post goes out only at a scheduled time or a queue slot, like one made in the app.

Addresses

The full list with inputs is in openapi.json. In short: GET /me, /brands, /accounts, /posts, /posts/{id}, /calendar?from=&to=, /library, /inbox, /inbox/{id}, /reports/summary, /credits, /credits/history, /brands/{id}/listening, /brands/{id}/competitors, /brands/{id}/ugc (where listening is set up); POST /media?brand= (the body is the file), POST /posts, PUT /posts/{id}, DELETE /posts/{id}, POST /posts/{id}/schedule, POST /posts/{id}/queue, POST /posts/{id}/comments, POST /inbox/{id}/reply.

curl -X POST -H "Authorization: Bearer rrs_..." -H "Content-Type: application/json" \
  -d '{"brandId": 1, "caption": "Hello", "accountIds": [3]}' https://social.roundrobin.in/api/v1/posts
curl -X POST -H "Authorization: Bearer rrs_..." -H "Content-Type: application/json" \
  -d '{"scheduledAt": "2026-11-02T10:30:00+05:30"}' https://social.roundrobin.in/api/v1/posts/42/schedule

Problems come back all at once, against their field: { "errors": { "caption": ["Write a caption."] } }. Anything else is { "error": "..." }.

More

  • Webhooks: a signed POST to your server when something happens.
  • CLI: rrsocial does the everyday jobs from your terminal.
  • MCP server: use Round Robin Social from Claude and other agents.