Browse documentation ⌄
GETTING STARTED
From zero to your first API post.
Connect a destination, create a scoped key, send one idempotent request, and confirm the per-platform result.
Before you begin
- Create or join a workspace.Every request runs inside a workspace containing brands, members, and connected accounts.
- Connect a social account.Open Brand → Social and complete the provider authorization flow.
- Create an API key.Open Settings → API Keys, select the required scopes, and store the key securely.
Publish a test post
cURLCopy and customize
curl -sS "https://app.postzivo.com/api/public/v1/posts" \
-X POST \
-H "Authorization: Bearer $POSTZIVO_API_KEY" \
-H "Idempotency-Key: quickstart-001" \
-H "x-postzivo-workspace-id: $WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{
"brand_id": "YOUR_BRAND_ID",
"content": "Hello from the Postzivo API!",
"platforms": ["linkedin"],
"publish_now": true
}'i
Start with one platform.
Once delivery succeeds, add destinations and platform-specific content fields.
Schedule instead
Replace publish_now with a future UTC timestamp in schedule_at. Postzivo stores the post and publishes it through the same retry-safe pipeline used by the dashboard.
JSON bodyCopy and customize
{
"brand_id": "YOUR_BRAND_ID",
"content": "This publishes Friday morning.",
"platforms": ["x", "linkedin"],
"schedule_at": "2026-08-07T09:00:00Z"
}Next steps
READY TO BUILD?
Connect your workflow.
Request access, create an API key, and start with one test workspace.