Social postings

A social posting is one post fanned out to one social account. It carries the per-target publish status and result (external URL, errors, credits charged). Social postings are read-only.

The social posting object

{
  "id": "sp_2Xa9kQ1mB3cD4eF5gH6iJ7kL8m",
  "post_id": "pst_2Xa...",
  "social_account_id": "sa_2Xa...",
  "platform": "linkedin",
  "status": "published",
  "error": null,
  "external_post_id": "urn:li:share:678",
  "external_url": "https://www.linkedin.com/feed/update/...",
  "credits_charged": 1,
  "created_at": "2026-06-25T08:00:00.000Z",
  "updated_at": "2026-06-26T15:00:05.000Z"
}

List social postings

GET /v1/social-postings

Lists every posting across the workspace, newest first.

curl https://api.socialit.com/v1/social-postings \
  -H "Authorization: Bearer sk_live_..."

{ "social_postings": [ { "id": "sp_...", "...": "..." } ] }

List postings for a post

GET /v1/posts/:id/social-postings

curl https://api.socialit.com/v1/posts/pst_2Xa.../social-postings \
  -H "Authorization: Bearer sk_live_..."

{ "social_postings": [ { "id": "sp_...", "...": "..." } ] }

Get a social posting

GET /v1/social-postings/:id

curl https://api.socialit.com/v1/social-postings/sp_2Xa... \
  -H "Authorization: Bearer sk_live_..."

{ "social_posting": { "id": "sp_...", "...": "..." } }