Skip to content
Docs

Reference

Every webhook event type Socialit emits, by area, with the shape of its data payload.

Updated Oct 14, 2026

This page is generated from the event catalog the API uses (packages/core/src/events.js), so it always matches what GET /v1/events/names returns and what webhooks can subscribe to. Every delivery wraps the event’s data in the same envelope; see Webhooks for signatures and retries.

  • Subscribe with events: ["post.published", …] on POST /v1/webhooks, or all_events: true for everything (including types added later).
  • Payloads embed full objects in their API shape (a post, a message, an account reference) unless noted.
  • Types are <object>.<past_tense_verb> and never renamed; new ones are added as features land.
Delivery body
{
  "id": "evt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
  "object": "event",
  "type": "post.published",
  "created_at": "2026-10-13T09:00:04.512Z",
  "workspace_id": "ws_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
  "test": false,
  "data": {
    "post": {
      "object": "post",
      "id": "pst_2LwQ9xKfT1mB7cRzV3nYp8aHsJd",
      "status": "published"
    }
  }
}

Posts

EventWhenPayload (data)
post.scheduledA post was scheduled for publishing.
post.publishingA post started publishing to its accounts.
post.publishedA post was published to every target account.
post.partially_publishedA post was published to some target accounts and failed on others.
post.failedA post failed to publish on every target account.
post.deletedA post was deleted from Socialit.
post.unpublishedA published post was removed from the network. data: { post, posting }.
post.cancelledA scheduled or publishing post was cancelled, or every published target was unpublished.
post.editedA published post was edited on the network. data: { post, posting }.
post.recycledAn evergreen post was cloned and rescheduled. data: { post (the clone), source_post_id }.
post.approval_requestedA post is waiting for approval. data: { post, approval }.
post.approvedA pending post was approved. data: { post, approval, comment }.
post.rejectedA pending post was rejected and moved back to draft. data: { post, approval, comment }.
posting.publishedOne target account finished publishing (before the post roll-up). data: { post, posting }.
posting.failedOne target account failed permanently (retryable failures stay quiet). data: { post, posting }.

Accounts

EventWhenPayload (data)
account.connectedA social account was connected or reconnected. Payload: { account, reconnected, connect_flow }.
account.disconnectedA social account was disconnected. Payload: { account, disconnection_type: intentional|unintentional, reason }.
account.needs_reconnectA social account lost its authorization and must be reconnected. Payload: { account, reason, platform_code }.
account.updatedA social account label, defaults or profile assignment changed. Payload: { account, changes }.

Inbox

EventWhenPayload (data)
message.receivedA direct message was received.Payloads: { message, conversation, account } (message.failed adds error).
message.sentA direct message was sent (from Socialit, or echoed from the network app).Payloads: { message, conversation, account } (message.failed adds error).
message.deliveredA sent direct message was delivered.Payloads: { message, conversation, account } (message.failed adds error).
message.readA sent direct message was read by the recipient.Payloads: { message, conversation, account } (message.failed adds error).
message.failedA sent direct message failed to deliver.Payloads: { message, conversation, account } (message.failed adds error).
message.editedA direct message was edited (payload carries the edit history).Payloads: { message, conversation, account } (message.failed adds error).
message.deletedA direct message was deleted or unsent.Payloads: { message, conversation, account } (message.failed adds error).
reaction.receivedA participant added or removed a reaction on a message.{ reaction: { emoji, action: added|removed, message_id, sender, reacted_at }, message, conversation, account }
conversation.createdA new conversation started.{ conversation, account }, conversation.updated adds changes[].
conversation.updatedA conversation changed (status, assignment, read state).{ conversation, account }, conversation.updated adds changes[].
conversation.control_changedConversation handover: the app answering a conversation changed.{ conversation, account, control: { owner, previous_owner, owner_app_id } }
comment.receivedA comment was received on a post.{ comment, post, account }
comment.repliedA reply was posted to a comment.{ comment, post, account }
comment.hiddenA comment was hidden.{ comment, post, account }
comment.unhiddenA hidden comment was made visible again.{ comment, post, account }
comment.deletedA comment was deleted.{ comment, post, account }
review.receivedA review was received.{ review, account }
review.updatedA reviewer edited their review text or rating.{ review, account }
review.repliedA reply was posted to a review.{ review, account }
mention.receivedThe account was mentioned.{ mention, account }

Contacts

EventWhenPayload (data)
contact.createdA contact was created.
contact.updatedA contact was updated.
contact.deletedA contact was deleted.
contact.tag_addedA tag was added to a contact (API, workflow add_tag node or comment-automation link click). Fires once per tag actually added; data: contact {id}, tag, source.
contact.tag_removedA tag was removed from a contact. Fires once per tag actually removed; data: contact {id}, tag, source.
contact.field_changedA contact custom field value changed (not on create); data: contact {id}, field, previous_value, value, source.

Messaging

EventWhenPayload (data)
broadcast.scheduledA broadcast was scheduled.
broadcast.sentA broadcast finished sending.
broadcast.failedA broadcast failed.
broadcast.sendingA broadcast started sending to its recipients.
broadcast.cancelledA scheduled or sending broadcast was cancelled.
sequence.enrolledA contact was enrolled in a sequence.
sequence.step_sentA sequence step was sent to a contact.
sequence.completedA contact completed a sequence.
sequence.exitedA contact left a sequence, finished or not; exit_reason says why (completed, replied, manual, failed, unsubscribed, sequence_deleted).
workflow.triggeredA workflow run started (Zernio workflow.run.started).
workflow.completedA workflow run ended; execution.status is completed, or exited for a run ended on purpose (Zernio workflow.run.completed).
workflow.failedA workflow run failed; error says which node failed and why (Zernio workflow.run.failed).

Ads

EventWhenPayload (data)
ad.createdAn ad was created through Socialit (create, boost, messaging / call ad, duplicate). data: { ad, campaign, ad_set }.
ad.updatedAn ad was updated through Socialit. data: { ad, changes }.
ad.deletedAn ad was deleted or archived through Socialit. data: { ad }.
ad.status_changedA campaign, ad set or ad changed effective status (sync, Meta webhook or a status write). data: { level, object, previous_status, status, platform_status, error, connection, ad_account } (Zernio ad.status_changed).
ad.video.processedAn async ad video finished processing (ready or error). data: { video, connection, ad_account } (Zernio ad.video.processed).
ad_campaign.createdAn ad campaign was created through Socialit. data: { campaign }.
ad_campaign.updatedAn ad campaign was updated through Socialit (name, budget, bidding, schedule). data: { campaign, changes }.
ad_campaign.deletedAn ad campaign was deleted or archived through Socialit. data: { campaign }.
ad_audience.createdA custom ad audience was created. data: { audience }.
ad_audience.deletedA custom ad audience was deleted. data: { audience }.
ad_insights_report.completedAn async ads insights report finished (completed or failed). data: { report }.
ad_connection.connectedAn ads connection was created or reconnected. data: { connection, ad_accounts, reconnected }.
ad_connection.disconnectedAn ads connection was disconnected. data: { connection, reason }.
ad_connection.needs_reconnectAn ads connection lost its authorization. data: { connection, reason, platform_code }.
ad_account.initial_sync_completedThe first sync and 90-day backfill of an ads connection finished. data: { connection, ad_accounts, sync } (Zernio account.ads.initial_sync_completed).
ad_account.sync_failedAn ad account has not synced for 24 hours. data: { connection, ad_account, sync } (Zernio account.ads.sync_failed).
ad_account.sync_recoveredA failing ad account synced again. data: { connection, ad_account, sync } (Zernio account.ads.sync_recovered).
lead.receivedA lead-gen form submission was stored (Meta leadgen webhook, a live form read, LinkedIn polling; test leads included). data: { lead, form: { id, name }, ad_account } (Zernio lead.received).
ad_account.createdAn ad account was created (POST /ads/accounts) or found by a re-discovery. data: { ad_account, connection }.
ad_account.updatedAn ad account changed (selection, profile, network settings, or name / status / currency on re-discovery). data: { ad_account, changes }.

Analytics

EventWhenPayload (data)
analytics.syncedAn account's analytics sync cycle completed (poll-driven, roughly hourly). A trigger to pull: the payload carries no metrics, only { account, sync: { synced_at, posts_updated } }.

Support assistant

EventWhenPayload (data)
support_run.completedThe support assistant finished a question; run.status is completed, or needs_human when it handed the question to a person. Unscoped (profile-filtered webhooks never receive it).
support_run.failedA support assistant question failed or expired. Unscoped.

Workspace

EventWhenPayload (data)
member.joinedA user joined the workspace.
member.removedA user was removed from the workspace.
webhook.testA test event sent from the dashboard or API.

Billing

EventWhenPayload (data)
billing.subscription_createdA plan subscription started (Stripe Checkout completed).data: { subscription } (docs/api/groups/billing.md)
billing.subscription_updatedThe plan, billing interval, extra accounts, status or scheduled cancellation changed.data: { subscription, previous: { plan, interval, extra_accounts, status, cancel_at_period_end } }
billing.subscription_canceledThe plan subscription ended; the workspace is back on Free.data: { subscription }
billing.invoice_paidAn invoice was paid.data: { invoice }
billing.payment_failedAn invoice payment failed; update the payment method to keep the plan.data: { invoice }
billing.credits_purchasedPrepaid credits (X API pass-through) were added.data: { credits: { amount_cents, balance_cents, pack_id, source } }
billing.accounts_over_limitConnected accounts exceed the plan allowance; publishing is paused for the accounts beyond it.data: { accounts: { used, limit, paused_account_ids } }