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/v1

Authentication

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_idsstring[]Required. 1–20 account ids from GET /v1/accounts.
textstringThe post text.
text_overridesobjectPer-platform text, e.g. {"twitter": "short version"}.
hashtagsstring[]Up to 60, added to the text.
media_idsstring[]Up to 10 ids from POST /v1/media. Several images make a carousel.
scheduled_atdate-timePublish later. Omit to publish now.
titlestringVideo title (YouTube).
platform_optionsobjectPlatform-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)
    path string

Media

  • POST/v1/mediaUpload Media

Posts

  • GET/v1/postsList Posts
    status
    query string · max 16 chars
    account_id
    query string · max 36 chars
    limit
    query integer · ≥ 1, ≤ 100, default 50
    cursor
    query string · max 36 chars
  • POST/v1/postsCreate Posts
    Idempotency-Key
    header string
  • GET/v1/posts/{post_id}Get Post
    post_id(required)
    path string
  • DELETE/v1/posts/{post_id}Delete Post
    post_id(required)
    path string
  • GET/v1/posts/{post_id}/metricsMetrics
    post_id(required)
    path string

Usage & balance

  • GET/v1/balanceBalance

Usage & balance

  • GET/v1/usageUsage
    days
    query integer · ≥ 1, ≤ 92, default 30

Platform rules

  • GET/v1/platform-rulesRules

Events

  • GET/v1/eventsEvents
    after
    query string
    types
    query string
    limit
    query integer · default 50

Comments

  • GET/v1/commentsComments
    account_id
    query string · default
    post_id
    query string · default
    limit
    query integer · default 50
  • POST/v1/comments/{comment_id}/replyReply
    comment_id(required)
    path string

Auto-replies

  • GET/v1/automationsList
    kind
    query string
  • POST/v1/automationsCreate
  • GET/v1/automations/{automation_id}Get
    automation_id(required)
    path string
  • PATCH/v1/automations/{automation_id}Patch
    automation_id(required)
    path string
  • DELETE/v1/automations/{automation_id}Delete
    automation_id(required)
    path string
  • GET/v1/automations/{automation_id}/runsRuns
    automation_id(required)
    path string

Assets

  • GET/v1/assets/logoGet Logo
    slot
    query string · default primary
  • PUT/v1/assets/logoPut Logo
    slot
    query string · default primary
  • DELETE/v1/assets/logoDelete Logo
    slot
    query string · 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)
    path string
  • PATCH/v1/assets/templates/{template_id}Patch
    template_id(required)
    path string
  • DELETE/v1/assets/templates/{template_id}Delete
    template_id(required)
    path string