Ctrl K
Automation
Payload Node.js
Outgoing webhooks
Receive a signed HTTP request in your own systems when posts are published or fail.
Events
Create webhooks under Developers. Each delivery is a POST with a JSON body.
| Event | Sent when |
|---|---|
| post.published | A post was delivered. |
| post.failed | A post failed on at least one account. |
| post.scheduled | A post was scheduled. |
| approval.requested | A post is waiting for approval. |
| review.decision | A client approved, asked for changes or commented through a review link. |
| account.needs_reconnect | A connected account expired or was revoked (data.account). |
{
"id": "evt_...",
"event": "post.published",
"created_at": "2026-11-02T04:00:12Z",
"workspace_id": "...",
"data": { }
}Verify the signature
Every request carries X-PlotPost-Signature: t=<unix>,v1=<hex>. v1 is the hex HMAC-SHA256 of "<t>.<raw body>" using your signing secret (shown once when you create the webhook). Reject requests whose t is older than a few minutes.
import crypto from 'node:crypto';
export function verify(rawBody, header, secret) {
const p = Object.fromEntries(header.split(',').map((x) => x.split('=')));
if (Math.abs(Date.now() / 1000 - Number(p.t)) > 300) return false;
const expected = crypto.createHmac('sha256', secret).update(`${p.t}.${rawBody}`).digest('hex');
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(p.v1));
}Retries
Failed deliveries are retried with exponential backoff. Return any 2xx status quickly and do your processing afterwards.