Skip to main content
Automation

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.

EventSent when
post.publishedA post was delivered.
post.failedA post failed on at least one account.
post.scheduledA post was scheduled.
approval.requestedA post is waiting for approval.
review.decisionA client approved, asked for changes or commented through a review link.
account.needs_reconnectA connected account expired or was revoked (data.account).
Payload
{
  "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.

Node.js
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.

v0.1.2

Outgoing webhooks | Documentation | Sociquza