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
| Header | Value |
|---|---|
X-Studio-Event | The event name, such as post.published |
X-Studio-Delivery | A unique delivery id. Use it to ignore duplicates |
X-Studio-Signature | sha256= followed by the HMAC of the body |
Was this helpful?
Ship on-brand posts in minutes
Back to documentationAI content, scheduling, engagement and a full marketing suite — free to start.
Start free









