Developer Docs
API & MCP Reference
Everything you need to integrate social publishing into your app, script, or AI agent workflow.
1
Quickstart
Authenticate with your API key and create a multi-channel post in a single request.
cURL
curl -X POST "$YOUR_BASE_URL/v1/post" \
-H "Authorization: Bearer <api_key>" \
-H "Content-Type: application/json" \
-d '{
"channels": ["twitter", "linkedin"],
"content": { "text": "Hello, world!" }
}'2
SDKs
Official client libraries for Node.js, Python, and Go. Install and start posting in minutes.
Node.js
import fetch from 'node-fetch';
await fetch(process.env.BASE_URL + '/v1/post', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + process.env.API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
channels: ['twitter', 'linkedin'],
content: { text: 'Ship once. Post everywhere.' }
})
});3
Webhooks
Receive delivery status events for each channel to track success, failures, and retries. Register a webhook endpoint in your dashboard, and Warply will POST event payloads as posts are published.
Webhook Payload
{
"event": "post.published",
"post_id": "post_7kx9m2",
"channel": "linkedin",
"published_at": "2026-03-15T09:00:12Z",
"status": "success"
}4
MCP Server
Connect any MCP-compatible AI agent to Warply. Agents discover tools automatically via the standard handshake and can draft, schedule, and publish posts.
MCP Configuration
{
"mcpServers": {
"warply": {
"url": "https://mcp.warply.app",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
}
}