API reference
The REST API publishes, schedules, deletes and measures posts on the accounts you connected in the Console.
Base URL
https://api.socialyfy.com/v1Authentication
Send your API key as a bearer token on every request. Keys are created on the Access page; each has its own permissions.
Authorization: Bearer sfk_…Every answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset.
Idempotent publishing
Send an Idempotency-Key header with POST /v1/posts. Repeating a request with the same key returns the first result instead of posting twice.
Create posts
POST /v1/posts takes one post for one or more accounts. Fields:
| account_ids | string[] | Required. 1–20 account ids from GET /v1/accounts. |
| text | string | The post text. |
| text_overrides | object | Per-platform text, e.g. {"twitter": "short version"}. |
| hashtags | string[] | Up to 60, added to the text. |
| media_ids | string[] | Up to 10 ids from POST /v1/media. Several images make a carousel. |
| scheduled_at | date-time | Publish later. Omit to publish now. |
| title | string | Video title (YouTube). |
| platform_options | object | Platform-specific options, e.g. YouTube privacy. |
202 Accepted
{
"data": [
{
"id": "c81e728d-9d4c-4f63-8f1a-0b6e2d5a9c47",
"platform": "linkedin",
"status": "scheduled",
"scheduled_at": "2026-11-24T09:00:00+00:00"
},
{
"id": "7d2a5b19-3c8e-4a06-b7f2-9e1d4c6a8b53",
"platform": "twitter",
"status": "scheduled",
"scheduled_at": "2026-11-24T09:00:00+00:00"
}
]
}Endpoints
Account
- GET
/v1/meMe
Accounts
- GET
/v1/accountsAccounts - GET
/v1/accounts/{account_id}Account- account_id(required)
pathstring
Media
- POST
/v1/mediaUpload Media
Posts
- GET
/v1/postsList Posts- status
querystring · max 16 chars- account_id
querystring · max 36 chars- limit
queryinteger · ≥ 1, ≤ 100, default 50- cursor
querystring · max 36 chars
- POST
/v1/postsCreate Posts- Idempotency-Key
headerstring
- GET
/v1/posts/{post_id}Get Post- post_id(required)
pathstring
- DELETE
/v1/posts/{post_id}Delete Post- post_id(required)
pathstring
- GET
/v1/posts/{post_id}/metricsMetrics- post_id(required)
pathstring
Usage & balance
- GET
/v1/balanceBalance
Usage & balance
- GET
/v1/usageUsage- days
queryinteger · ≥ 1, ≤ 92, default 30
Platform rules
- GET
/v1/platform-rulesRules
Events
- GET
/v1/eventsEvents- after
querystring- types
querystring- limit
queryinteger · default 50
Comments
- GET
/v1/commentsComments- account_id
querystring · default- post_id
querystring · default- limit
queryinteger · default 50
- POST
/v1/comments/{comment_id}/replyReply- comment_id(required)
pathstring
Auto-replies
- GET
/v1/automationsList- kind
querystring
- POST
/v1/automationsCreate - GET
/v1/automations/{automation_id}Get- automation_id(required)
pathstring
- PATCH
/v1/automations/{automation_id}Patch- automation_id(required)
pathstring
- DELETE
/v1/automations/{automation_id}Delete- automation_id(required)
pathstring
- GET
/v1/automations/{automation_id}/runsRuns- automation_id(required)
pathstring
Assets
- GET
/v1/assets/logoGet Logo- slot
querystring · default primary
- PUT
/v1/assets/logoPut Logo- slot
querystring · default primary
- DELETE
/v1/assets/logoDelete Logo- slot
querystring · default primary
- POST
/v1/assets/logo/from-urlLogo From Url - GET
/v1/assets/templatesList - POST
/v1/assets/templatesCreate - GET
/v1/assets/templates/{template_id}Get- template_id(required)
pathstring
- PATCH
/v1/assets/templates/{template_id}Patch- template_id(required)
pathstring
- DELETE
/v1/assets/templates/{template_id}Delete- template_id(required)
pathstring