Webhooks

Webhook events

Every event you can subscribe to, with an example payload for each.

Oct 11, 20261 min read

Every event uses the same envelope. event tells you which one it is, and data holds its details.

post.published

A scheduled post was delivered to all of its platforms.

{
  "event": "post.published",
  "workspaceId": "cml0ws789",
  "createdAt": "2026-10-09T14:03:00.000Z",
  "data": {
    "scheduledPostId": "cml0abc123",
    "platforms": [
      "instagram",
      "x"
    ]
  }
}

post.failed

A scheduled post could not be delivered after every retry.

{
  "event": "post.failed",
  "workspaceId": "cml0ws789",
  "createdAt": "2026-10-09T14:03:00.000Z",
  "data": {
    "scheduledPostId": "cml0abc123",
    "platforms": [
      "instagram",
      "linkedin"
    ],
    "failedPlatforms": [
      "linkedin"
    ],
    "error": "The access token has expired. Reconnect the account.",
    "failureKind": "auth_expired"
  }
}

review.received

A new review arrived from a connected profile.

{
  "event": "review.received",
  "workspaceId": "cml0ws789",
  "createdAt": "2026-10-09T14:03:00.000Z",
  "data": {
    "reviewId": "cml0rev456",
    "platform": "google_business",
    "rating": 5,
    "authorName": "Jane Cooper",
    "text": "Fast, friendly and on time."
  }
}

lead.captured

Someone submitted a lead form on one of your Link in Bio pages.

{
  "event": "lead.captured",
  "workspaceId": "cml0ws789",
  "createdAt": "2026-10-09T14:03:00.000Z",
  "data": {
    "email": "jane@acme.com",
    "smartLinkId": "sl_42",
    "form": "Join the waitlist"
  }
}

Headers

HeaderValue
X-Studio-EventThe event name, such as post.published
X-Studio-DeliveryA unique delivery id. Use it to ignore duplicates
X-Studio-Signaturesha256= followed by the HMAC of the body
Was this helpful?
Ship on-brand posts in minutes

AI content, scheduling, engagement and a full marketing suite — free to start.

Start free
Back to documentation

Keep reading

Put this into practice in AeroReply

Every tool lives in the same account, from the free plan up.

Put this into practice

Start free — design, schedule and grow from one workspace.

  • No credit card
  • 2-minute setup
  • Cancel anytime