Quickstart
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.
-
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. -
Find your accounts. List the connected accounts and note the IDs (
sa_…) you want to publish to.curl https://api.socialit.com/v1/accounts \ -H "Authorization: Bearer $SOCIALIT_API_KEY" -
Upload media (optional). Upload an image or video once and reuse its
med_…ID in any post. -
Create the post. One request publishes to every account in
account_ids. Setscheduled_atto schedule it, or leave it out to publish now. -
Listen for the result. Add a webhook for
post.publishedandpost.failed, or pollGET /v1/posts/{id}.
Create the post
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"
}'const res = await fetch('https://api.socialit.com/v1/posts', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.SOCIALIT_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'launch-2026-10-14',
},
body: JSON.stringify({
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',
}),
});
const post = await res.json();import os, requests
post = requests.post(
"https://api.socialit.com/v1/posts",
headers={"Authorization": f"Bearer {os.environ['SOCIALIT_API_KEY']}"},
json={
"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",
},
).json()The response is the post with one posting per target account:
{
"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.publishedand verify signatures. - Network guides: what each network accepts.