Skip to content
Docs

Reference

The Socialit REST API v1: base URL, authentication, conventions and every resource.

Updated Oct 14, 2026

The Socialit API is a REST API over HTTPS with JSON bodies. Every endpoint is generated from our OpenAPI 3.1 document, which you can download from https://api.socialit.com/v1/openapi.json to generate a client in any language.

GEThttps://api.socialit.com/v1

Conventions

  • Authentication: Authorization: Bearer <API key or OAuth token>. See Authentication.
  • Objects: flat JSON, snake_case fields, an object type and prefixed IDs. See Objects and IDs.
  • Creates return 201 with the object; updates use PATCH and return 200 with the full object; deletes return 200 with { "object", "id", "deleted": true }; actions are POST /resource/{id}/{verb}.
  • Lists share one envelope, filters and sorting. See Pagination and filtering.
  • Errors share one shape everywhere. See Errors.
  • Retries: send an Idempotency-Key on creates. See Idempotency.
  • Limits: per workspace, with RateLimit-* headers. See Rate limits.

Resources

Resources are grouped like the sidebar. Each page lists its endpoints with parameters, request and response schemas, examples and code samples in cURL, Node.js, Python, PHP and Go, plus the MCP tool call. Every operation is also an MCP tool named after its operation ID in kebab-case (createPost → create-post), shown on each endpoint.

The OpenAPI document carries the same metadata as vendor extensions: x-tagGroups, and per operation x-access (scope), x-mcp-tool, x-toolset, x-idempotent and x-zernio (the Zernio operations it replaces).

2,621 endpoints in 41 resources.

Core

Profiles, connected social accounts and connect flows, API keys, webhooks, events, logs and the team.

  • Accounts · 44Profiles, account groups, connected social accounts and connect flows.
  • API Keys · 7Workspace API keys.
  • Webhooks · 12Signed HTTPS callbacks for workspace events.
  • Events · 3The workspace event log (the payloads webhooks receive) and the event type catalog.
  • Logs · 3API request logs (public API + MCP) and the workspace activity log.
  • Invitations · 1Email invitations, invite codes and invite links.
  • Users · 2People with access to the workspace.

Publishing

Posts, queues, media, templates and validation tools.

  • Posts · 24Create, schedule and publish posts to connected accounts; track per-account results.
  • Queues · 7Recurring posting schedules.
  • Media · 10Upload images, videos and documents for posts (and inbox attachments).
  • Templates · 5Reusable post content with media and network options.
  • Tools · 7Validate posts and media before publishing; feedback and changelog.

Inbox

Direct messages, comments, reviews and mentions across networks.

  • Inbox · 72Unified inbox: direct messages, comments, reviews and mentions across networks, plus messaging settings, X engagement and Reddit discovery.

Analytics

Post, account, platform-native and inbox analytics.

  • Analytics · 40Post and account analytics, platform-native insights and inbox analytics.

Automation & CRM

Contacts, custom fields, broadcasts, sequences, workflows and comment-to-DM automations.

  • Contacts · 16CRM contacts: one person across platforms, linked to channels (per-account platform identities such as an Instagram or Messenger user ID).
  • Custom Fields · 5Contact custom field definitions (text, number, date, boolean, select).
  • Broadcasts · 11Bulk sends to contacts on one account (Messenger / Instagram within the 24 h window or with HUMAN_AGENT, X, Bluesky…), rate limited per channel with per-recipient delivery status.
  • Sequences · 10Time-based drips: ordered steps (delay, message, optional condition) sent to enrolled contacts on one account; contacts exit on reply or unsubscribe.
  • Workflows · 18Event-driven automation graphs: a trigger (message, keyword, comment, referral, reaction, contact change, API call, schedule) and nodes (send message, reply / private reply, wait, condition, HTTP request, AI reply with Claude, tags, fields, sequences, assignment).
  • Comment Automations · 6Comment-to-DM (ManyChat-style): keyword rules per account or post answer comments with a private DM (Instagram, Facebook) and / or a public reply (also TikTok, Threads, LinkedIn, YouTube, Bluesky, Reddit), with audience filters, follow gates, repeat policies and tracked links.

Ads

Ads connections, campaigns, ad sets, ads, audiences, insights, lead gen and conversions.

  • Ads · 123Unified ads across Meta, Google, LinkedIn, TikTok, Pinterest, X, Reddit and OpenAI (ChatGPT) Ads: connections, campaigns, ad sets, ads, creatives, insights, targeting, audiences, Google Ads specifics, Ad Library, Reach & Frequency.
  • Ads: accounts & measurement · 135Ad accounts, account-level ad management, tracking tags, lead gen, product catalogs and conversions.

Platform tools

Network-specific helpers on one connected account.

  • Platform tools · 91Network-specific tools on a connected account: Google Business Profile listing, reviews, media and verification; Facebook Pages; LinkedIn organizations and mentions; Instagram stories, audio and discovery; Pinterest boards; YouTube playlists and transcripts; Reddit subreddits, flairs and votes; TikTok creator info; Discord server management; Bluesky settings.

Focus mode

Everything a network API allows for one connected account: the generic manifest operations and the typed per-network operations (Focus · <Network>).

  • Generic operations · 10Focus mode: everything a network's API allows for one connected account.
  • Bluesky · 168Typed Focus mode operations for Bluesky accounts, generated from the Bluesky focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • Discord · 145Typed Focus mode operations for Discord accounts, generated from the Discord focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • Facebook Page · 158Typed Focus mode operations for Facebook Page accounts, generated from the Facebook Page focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • Google Business Profile · 89Typed Focus mode operations for Google Business Profile accounts, generated from the Google Business Profile focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • Instagram · 103Typed Focus mode operations for Instagram accounts, generated from the Instagram focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • LinkedIn · 64Typed Focus mode operations for LinkedIn accounts, generated from the LinkedIn focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • Mastodon · 337Typed Focus mode operations for Mastodon accounts, generated from the Mastodon focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • Pinterest · 64Typed Focus mode operations for Pinterest accounts, generated from the Pinterest focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • Reddit · 292Typed Focus mode operations for Reddit accounts, generated from the Reddit focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • Snapchat · 56Typed Focus mode operations for Snapchat accounts, generated from the Snapchat focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • Threads · 57Typed Focus mode operations for Threads accounts, generated from the Threads focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • TikTok · 65Typed Focus mode operations for TikTok accounts, generated from the TikTok focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • X · 177Typed Focus mode operations for X accounts, generated from the X focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
  • YouTube · 170Typed Focus mode operations for YouTube accounts, generated from the YouTube focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Account & billing

Plans, subscriptions, usage, connected apps and the support assistant.

  • Billing · 9Plans, subscriptions, payment methods, invoices, usage and prepaid credits.
  • Connected Apps · 2Third-party apps and AI agents connected with OAuth.
  • Support Assistant · 3Ask Socialit support questions (failed posts, account connection, API usage).