Skip to content
Docs

Quickstart

Create an API key, find your connected accounts and publish one post to three networks.

Updated Oct 14, 2026

This quickstart takes about five minutes. You need a Socialit account (Free works) with at least one connected social account.

  1. Create an API key. In the app, open Manage → API keys and select Create key. Copy the secret (sk_live_…); it is shown once. See Authentication.

  2. Find your accounts. List the connected accounts and note the IDs (sa_…) you want to publish to.

    Terminal
    curl https://api.socialit.com/v1/accounts \
      -H "Authorization: Bearer $SOCIALIT_API_KEY"
  3. Upload media (optional). Upload an image or video once and reuse its med_… ID in any post.

  4. Create the post. One request publishes to every account in account_ids. Set scheduled_at to schedule it, or leave it out to publish now.

  5. Listen for the result. Add a webhook for post.published and post.failed, or poll GET /v1/posts/{id}.

Create the post

Terminal
curl https://api.socialit.com/v1/posts \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-2026-10-14" \
  -d '{
    "content": "Focus mode is live. Open one account, use everything.",
    "account_ids": ["sa_instagram…", "sa_linkedin…", "sa_x…"],
    "scheduled_at": "2026-10-14T09:00:00.000Z",
    "first_comment": "#focusmode"
  }'

The response is the post with one posting per target account:

JSON
{
  "object": "post",
  "id": "pst_2LwQ9xKfT1mB7cRzV3nYp8aHsJd",
  "status": "scheduled",
  "scheduled_at": "2026-10-14T09:00:00.000Z",
  "postings": [
    { "object": "posting", "platform": "instagram", "status": "pending" },
    { "object": "posting", "platform": "linkedin", "status": "pending" },
    { "object": "posting", "platform": "x", "status": "pending" }
  ]
}

Next steps

  • Publishing: queues, drafts, per-network options, editing and deleting.
  • Webhooks: receive post.published and verify signatures.
  • Network guides: what each network accepts.