GET
/contextRead account context
Returns the token owner's account, active brands, default brand, and scopes.
Developer documentation
Build AI agents and automations on DoroSocial.
The DoroSocial Public API lets trusted apps, scripts, and AI agents create content, upload source media, create or schedule platform posts, and read publishing status.
Quickstart
Connect an app in four steps
1
Create an API token
Open Settings > API tokens, choose an access level, set an expiration, and copy the token when it is shown.
2
Read brand context
Call /context first so your integration knows which brand IDs and scopes the token can use.
3
Create content and posts
Create a source content item, then attach draft or scheduled posts to that content item.
4
Check publishing status
Poll post status when your workflow needs to confirm scheduled, published, or failed posts.
Authentication
API tokens are available to paid, email-verified users. Tokens are shown once, can be revoked from Settings, and should never be stored in public prompts, screenshots, logs, or source code.
curl https://doro.social/api/v1/public/context \
-H "Authorization: Bearer $DORO_API_TOKEN"Brand context
Most write operations need a brand. If the account has one active brand, DoroSocial can default to it. If the account has more than one active brand, include brand_id.
curl https://doro.social/api/v1/public/context \
-H "Authorization: Bearer $DORO_API_TOKEN"Common workflows
Core endpoints
POST
/contentCreate content
Creates a source content item that posts can be attached to.
POST
/postsCreate or schedule a post
Creates a draft post, or schedules it when scheduled_for is present.
GET
/postsList posts
Lists posts for a brand, optionally filtered by content, platform, or status.
GET
/posts/{post_id}/statusRead post status
Returns the post status, published URL, and error details when publishing fails.
Scopes
Choose the narrowest access that still lets the integration do its job.
brand:readRead account and brand context.
content:createCreate source content items.
media:uploadUpload source media through multipart upload routes.
posts:createCreate platform post drafts.
posts:scheduleSchedule posts for future publishing.
posts:readRead post status and publishing results.
Need the raw files?
Use the human docs for implementation planning, and the OpenAPI file for Postman, SDK generators, agent tools, and API clients.