Webhooks Overview - Social media studio

Webhooks allow you to build or set up integrations that subscribe to real-time events on Social media studio. When an event is triggered, we send an HTTP POST payload to your configured URL, letting your application react instantly without polling.

Configuration Basics

You can configure webhooks directly via the dashboard under Settings > Webhooks or by using our API. Each webhook requires:

A valid Endpoint URL (HTTPS strongly recommended).
One or more Event Categories you wish to subscribe to.

Property	Value
Transport	HTTP POST
Content-Type	`application/json`
Timeout	10 seconds
Max Payload Size	64 KB

Your plan determines how many active webhook subscriptions you can maintain simultaneously.

Payload Template Examples

Use payloadTemplate to customize the JSON body sent to your endpoint. Available template variables are:

{{event}}
{{category}}
{{timestamp}}
{{data}}
{{data.any_field}} (for nested event-specific fields)

1) Generic JSON Envelope

{
  "event": "{{event}}",
  "category": "{{category}}",
  "occurredAt": "{{timestamp}}",
  "payload": {{data}}
}

2) Discord-Friendly Payload

{
  "content": "🚀 {{event}}",
  "username": "Social media studio Webhooks",
  "embeds": [
    {
      "title": "Webhook Event",
      "description": "Post {{data.postId}} on {{data.platform}}",
      "fields": [
        { "name": "Category", "value": "{{category}}" },
        { "name": "Time", "value": "{{timestamp}}" }
      ]
    }
  ]
}

3) Slack Block Kit Style Payload

{
  "text": "Social media studio event: {{event}}",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*Event:* `{{event}}`\n*Category:* `{{category}}`\n*Post:* `{{data.postId}}`\n*Platform:* `{{data.platform}}`\n*At:* `{{timestamp}}`"
      }
    }
  ]
}

If a variable is missing in the underlying event data, the placeholder remains unchanged (for example, {{data.postId}}).

Webhook Limits & Retention

Depending on your subscription plan, the retention of your webhook delivery logs and the number of webhook endpoints you can create varies:

Limits by Plan
Retry Policy

Plan	Max Subscriptions	Log Retention
Free	0	None
Lite	3 endpoints	30 days
Standard	10 endpoints	60 days
Advanced	25 endpoints	90 days

If your endpoint returns an error (HTTP status >= 400) or times out (after 10 seconds), Social media studio will automatically retry sending the event.The system attempts up to 4 retries with backoff delays of:

1st retry: 30 seconds
2nd retry: 2 minutes
3rd retry: 10 minutes
4th retry: 1 hour

If a webhook fails consecutively 10 times, it will be automatically disabled to prevent system strain.

Available Events

We support 147 events across 26 categories. When you subscribe to a category, you receive all related events. You can also subscribe to individual events for finer-grained control.

Post (10 events)

Event	Description
`post.created`	A new post was created
`post.updated`	A post’s content or schedule was changed
`post.deleted`	A post was deleted
`post.bulk_deleted`	Multiple posts were deleted in one operation
`post.published`	A post was successfully published to its platform
`post.failed`	A scheduled post failed to publish
`post.retried`	A failed post was put back into the queue
`post.scheduled`	A post was added to the publishing queue
`post.unscheduled`	A post was removed from the publishing queue
`post.resubmitted`	A rejected post was resubmitted for approval

Draft (4 events)

Event	Description
`draft.created`	A draft post was created
`draft.updated`	A draft post was updated
`draft.deleted`	A draft post was deleted
`draft.converted`	A draft was converted into a scheduled/published post

Approval (6 events)

Event	Description
`post.approval.requested`	A post was submitted for approval
`post.approval.approved`	A pending post was approved
`post.approval.rejected`	A pending post was rejected
`post.approval.comment_added`	A reviewer added a comment to a post
`post.approval.comment_updated`	A reviewer’s comment was edited
`post.approval.comment_deleted`	A reviewer’s comment was deleted

Event	Description
`social.account_connected`	A social network account was authorized
`social.account_disconnected`	A social account connection was removed
`social.account_token_refreshed`	A social account OAuth token was refreshed

Media (9 events)

Event	Description
`media.uploaded`	A file was uploaded to the media library
`media.deleted`	A media file was deleted
`media.bulk_deleted`	Multiple media files were deleted in one operation
`media.moved`	A media file was moved to a different folder
`media.folder_created`	A new media folder was created
`media.folder_renamed`	A media folder was renamed
`media.folder_deleted`	A media folder was deleted
`media.folder_moved`	A media folder was moved
`media.canva_imported`	A design was imported from Canva into the library

Composer (3 events)

Event	Description
`composer.reel_created`	A new reel/video was created in the composer
`composer.reel_updated`	An existing reel/video was updated
`composer.reel_deleted`	A reel/video was deleted

Analytics (1 event)

Event	Description
`analytics.report_generated`	A scheduled analytics refresh cycle completed (every 2 hours for tenants with connected social accounts)

Best Time (2 events)

Event	Description
`best_time.recommendation_generated`	A best-time-to-post recommendation was computed for an account for the first time
`best_time.recommendation_recomputed`	An existing best-time recommendation was refreshed (daily cron or manual recompute)

Inbox (16 events)

Event	Description
`inbox.message_received`	An incoming DM was received
`inbox.message_sent`	An outgoing DM was sent
`inbox.comment_received`	An incoming social comment was received
`inbox.comment_sent`	An outgoing reply to a social comment was sent
`inbox.comment_hidden`	A social comment was hidden
`inbox.comment_edited`	A social comment was edited
`inbox.comment_removed`	A social comment was removed entirely
`inbox.conversation_created`	A new conversation thread began
`inbox.conversation_deleted`	A conversation was deleted
`inbox.conversation_archived`	A conversation was archived
`inbox.conversation_resolved`	A conversation was marked as resolved
`inbox.subscribed`	The inbox was subscribed for a connected account/platform
`inbox.unsubscribed`	The inbox was unsubscribed for a connected account/platform
`inbox.saved_reply_created`	A saved reply template was created
`inbox.saved_reply_updated`	A saved reply template was updated
`inbox.saved_reply_deleted`	A saved reply template was deleted

Biolink (17 events)

Event	Description
`biolink.created`	A biolink page was created
`biolink.updated`	A biolink page was updated
`biolink.deleted`	A biolink page was deleted
`biolink.published`	A biolink page was made public
`biolink.unpublished`	A biolink page was made private
`biolink.theme_changed`	A biolink switched to a different preset theme
`biolink.custom_theme_set`	A biolink custom theme was configured
`biolink.button_added`	A button was added to a biolink
`biolink.button_updated`	A biolink button was updated
`biolink.button_removed`	A biolink button was removed
`biolink.button_reordered`	Biolink buttons were reordered
`biolink.post_created`	An Instagram post embed was added to a biolink
`biolink.post_updated`	A biolink post embed was updated
`biolink.post_deleted`	A biolink post embed was removed
`biolink.post_reordered`	Biolink post embeds were reordered
`biolink.profile_image_uploaded`	A biolink profile image was uploaded
`biolink.profile_image_deleted`	A biolink profile image was removed

WhatsApp (4 events)

Event	Description
`whatsapp.template_created`	A WhatsApp message template was submitted for approval
`whatsapp.template_deleted`	A WhatsApp message template was deleted
`whatsapp.template_media_uploaded`	Media was uploaded to back a WhatsApp template
`whatsapp.message_sent`	A WhatsApp template message was sent to a recipient

AI (8 events)

Event	Description
`ai.text_generated`	An AI text completion finished
`ai.caption_generated`	An AI post caption was generated
`ai.image_generated`	An AI image task completed successfully
`ai.image_failed`	An AI image task failed
`ai.image_deleted`	A generated AI image was deleted
`ai.video_generated`	An AI video task completed successfully
`ai.video_failed`	An AI video task failed
`ai.video_deleted`	A generated AI video was deleted

Knowledge Hub (4 events)

Event	Description
`knowledge.created`	A knowledge document was added to the RAG hub
`knowledge.updated`	A knowledge document’s metadata or note body was updated
`knowledge.deleted`	A knowledge document was removed
`knowledge.reprocessed`	A knowledge document’s text extraction was re-run

Team (6 events)

Event	Description
`team.invitation_sent`	A team invitation was sent
`team.invitation_cancelled`	A pending team invitation was cancelled
`team.member_joined`	A new member accepted their invitation
`team.member_left`	A member left the organization voluntarily
`team.member_removed`	A member was removed by an owner
`team.permission_updated`	A member’s role was changed

Organization (8 events)

Event	Description
`organization.created`	A new organization was created
`organization.deleted`	An organization was deleted
`organization.member_left`	A member left the organization
`organization.name_updated`	Organization name was updated
`organization.logo_updated`	Organization logo was updated
`organization.description_updated`	Organization description was updated
`organization.theme_updated`	Organization UI theme was updated
`organization.timezone_updated`	Organization default timezone was updated

Account & Profile (7 events)

Event	Description
`account.updated`	A social account’s settings were updated
`account.token_expired`	A social account’s session token was detected as expired
`profile.updated`	A user profile was updated
`profile.email_updated`	A user’s email address was changed
`profile.password_changed`	A user’s password was changed
`profile.avatar_uploaded`	A user uploaded a profile picture
`profile.avatar_deleted`	A user removed their profile picture

Auth (8 events)

Event	Description
`auth.registered`	A user completed signup
`auth.login`	A user logged in
`auth.logout`	A user logged out
`auth.email_verified`	A user verified their email address
`auth.password_reset_requested`	A password reset email was sent
`auth.password_reset_completed`	A user completed a password reset
`auth.verification_resent`	A verification email was re-sent
`auth.refresh_token_issued`	A new refresh token was issued

Subscription & Billing (8 events)

Event	Description
`subscription.created`	A new subscription started
`subscription.plan_changed`	The subscription’s plan was applied
`subscription.canceled`	A subscription was canceled
`subscription.payment_failed`	A recurring invoice payment failed
`subscription.expired`	An unpaid or canceled subscription expired
`subscription.upgraded`	A subscription was upgraded to a higher-tier plan
`subscription.downgrade_requested`	A downgrade was scheduled for the period end
`subscription.downgrade_cancelled`	A pending downgrade was cancelled

API Key (2 events)

Event	Description
`api_key.created`	A new developer API key was generated
`api_key.revoked`	An API key was revoked

Webhook (5 events)

Event	Description
`webhook.created`	A new webhook subscription was created
`webhook.updated`	A webhook endpoint or categories were changed
`webhook.deleted`	A webhook subscription was deleted
`webhook.enabled`	A webhook subscription was enabled
`webhook.disabled`	A webhook subscription was disabled

Integration (2 events)

Event	Description
`integration.connected`	A third-party integration was connected
`integration.disconnected`	A third-party integration was disconnected

Support (8 events)

Event	Description
`support.ticket_created`	A new support ticket was created
`support.ticket_updated`	A support ticket was updated
`support.ticket_closed`	A support ticket was closed
`support.ticket_assigned`	A support ticket was assigned to an agent
`support.ticket_reply`	A support agent replied to a ticket
`support.ticket_message_received`	An incoming ticket message was received
`support.ticket_message_sent`	An outgoing ticket message was sent
`support.ticket_reopened`	A closed ticket was reopened

Template (1 event)

Event	Description
`template.rendered`	A content template was rendered with field substitution

MCP (1 event)

Event	Description
`mcp.usage_logged`	An MCP tool call was logged and billed

Quota (1 event)

Event	Description
`quota.limit_reached`	A plan-level quota (e.g. AI credits, API calls) was reached

Referral (3 events)

Event	Description
`referral.code_created`	A user’s referral code was created
`referral.code_used`	A new signup used the referrer’s code
`referral.reward_earned`	A referral was completed and credits were awarded

Need to inspect payloads?

Webhooks always deliver events mapped to our official schema. Learn how to verify signatures and see example payloads for each event category.

​Configuration Basics

​Payload Template Examples

​1) Generic JSON Envelope

​2) Discord-Friendly Payload

​3) Slack Block Kit Style Payload

​Webhook Limits & Retention

​Available Events

Need to inspect payloads?

Configuration Basics

Payload Template Examples

1) Generic JSON Envelope

2) Discord-Friendly Payload

3) Slack Block Kit Style Payload

Webhook Limits & Retention

Available Events