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.