Browse documentation ⌄
Build, automate, and
publish from anywhere.
Everything you need to connect apps and AI agents to Postzivo’s publishing, scheduling, engagement, and analytics workflows.
Start with the workflow that fits.
REST API
Publish, schedule, upload media, read analytics, and connect your own product.
View API guide →✦CONNECTMCP Server
Give ChatGPT, Claude, Cursor, and custom agents direct access to Postzivo tools.
Set up MCP →⚡AUTOMATEIntegrations
Trigger social workflows from n8n, Make, Zapier, webhooks, or any HTTP client.
Explore integrations →▦LEARNApp Guides
Understand campaigns, calendars, approvals, workspaces, the inbox, and analytics.
See the product →Your first API-powered post.
Connect an account inside Postzivo, create an API key, and send one authenticated request.
- 1Connect a social account
Open Brand → Social inside the dashboard and connect at least one publishing destination.
- 2Create an API key
Go to Settings → API Keys. Store the key securely—it is shown only once.
- 3Send your first request
Use the example below with your brand and workspace identifiers.
A predictable API for every social workflow.
Use Postzivo from server-side applications, internal tools, CI/CD jobs, automations, or any client capable of making HTTPS requests.
https://app.postzivo.com/api/public/v1Core endpoints
/postsCreate, publish, or schedule a post/postsList posts by status, brand, or date/media/upload-urlCreate a signed media upload URL/analyticsRead cross-platform performance/workspacesList accessible workspacesCreate and publish a post
curl -sS "https://app.postzivo.com/api/public/v1/posts" \
-X POST \
-H "Authorization: Bearer $POSTZIVO_API_KEY" \
-H "Idempotency-Key: post-$(uuidgen)" \
-H "x-postzivo-workspace-id: $WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{
"brand_id": "YOUR_BRAND_ID",
"content": "A smarter way to run social.",
"platforms": ["linkedin", "instagram"],
"publish_now": true
}'TypeScript / Node.js
const response = await fetch(
"https://app.postzivo.com/api/public/v1/posts",
{
method: "POST",
headers: {
Authorization: "Bearer " + process.env.POSTZIVO_API_KEY,
"Idempotency-Key": crypto.randomUUID(),
"x-postzivo-workspace-id": process.env.WORKSPACE_ID,
"Content-Type": "application/json"
},
body: JSON.stringify({
brand_id: process.env.BRAND_ID,
content: "Posting from Postzivo!",
platforms: ["linkedin", "instagram"],
publish_now: true
})
}
);
const result = await response.json();
if (!result.success) throw new Error(result.error.code);
console.log(result.data.post_id);Keep keys on the server.
Never expose a Postzivo API key in browser JavaScript, mobile bundles, public repositories, or client-side environment variables.
Secure by default, scoped to your workspace.
Send your API key as a bearer token on every request. Write operations also use an idempotency key so retrying cannot accidentally publish twice.
Authorization: Bearer postzivo_live_xxx
Content-Type: application/json
Idempotency-Key: <unique-string>
x-postzivo-workspace-id: <workspace-uuid>Create separate keys for publishing, analytics, and automation workloads.
Issue the replacement before revoking the old key to avoid downtime.
API and agent activity appears in the workspace activity log.
Let your AI agent operate Postzivo.
Connect any MCP-compatible client to the hosted streamable HTTP endpoint. Your agent can create drafts, schedule posts, manage approvals, read the calendar, triage engagement, and fetch analytics.
https://app.postzivo.com/mcp{
"mcpServers": {
"postzivo": {
"url": "https://app.postzivo.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Draft captions, posts, campaign variants, and media briefs.
Act across connected accounts using your workspace rules.
Submit drafts, approve, reject, or return work for edits.
Pull post analytics and turn signals into next actions.
“Create a launch campaign for LinkedIn, Instagram, and TikTok. Keep every post in review, schedule approved drafts for next week, then summarize the calendar.”
Connect the stack you already use.
Use an HTTP request action in any automation platform. Send the same bearer token, workspace header, and JSON body used in the REST examples.
Use the HTTP Request node with Header Auth and JSON body mode.
https://app.postzivo.com/api/public/v1/postsAdd HTTP → Make a request, select POST, and map fields from your trigger.
https://app.postzivo.com/api/public/v1/postsUse Webhooks by Zapier → Custom Request to publish from any Zap.
https://app.postzivo.com/api/public/v1/postsUse MCP for tool discovery or REST when you want direct orchestration.
https://app.postzivo.com/mcpPublish across eleven destinations.
Design integrations that recover cleanly.
400Validation error
Inspect the response field details and correct the request body.
401Unauthorized
The bearer token is missing, expired, revoked, or invalid.
403Insufficient scope
The API key or user cannot perform this action in the workspace.
429Rate limited
Wait for the Retry-After duration, then retry with the same idempotency key.
5xxTemporary service error
Retry with exponential backoff and preserve the idempotency key.
Connect your first workflow.
Create an API key inside Postzivo, connect your accounts, and turn your first request into a scheduled campaign.