Webhooks
Signed HTTPS callbacks for workspace events. Each delivery carries X-Socialit-Signature (hex HMAC-SHA256 of ${timestamp}.${body} with the webhook secret) and X-Socialit-Timestamp. Failed deliveries retry after 5m, 30m, 2h, 5h, then every 12h (11 attempts); a webhook failing for 3 days is disabled.
List webhooks
/webhooksTry it with MCPAsk your agent to call list-webhooks (toolset webhooks)Set up MCP
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringcreated_atnamelast_delivery_at
orderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
enabledstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 14 item attributes
objectstringwebhook
idstringnamestringurlstringenabledbooleanall_eventsbooleaneventsarray of stringprofile_idsarray of string | nullsecretstringSigning secret. Only returned on create and reset-secret.
last_delivery_atstring (date-time) | nullfailure_countintegerdisabled_reasonstring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
{
"object": "list",
"data": [
{
"object": "webhook",
"id": "string",
"name": "string",
"url": "https://example.com",
"enabled": true,
"all_events": true,
"events": [
"string"
],
"profile_ids": [
"string"
],
"secret": "string",
"last_delivery_at": "2026-10-13T09:00:00.000Z",
"failure_count": 1,
"disabled_reason": "string",
"created_at": "2026-10-13T09:00:00.000Z",
"updated_at": "2026-10-13T09:00:00.000Z"
}
],
"page": 1,
"limit": 1,
"total": 1,
"has_more": true,
"next_page_url": "https://example.com",
"previous_page_url": "https://example.com"
}Create a webhook
/webhooksThe response contains the signing secret; it is only shown again after reset-secret.
Try it with MCPAsk your agent to call create-webhook (toolset webhooks)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–100 characters
urlstringrequired8–2048 characters
eventsarray of string≤ 200 items · unique
all_eventsbooleanprofile_idsarray of string | null≤ 500 items
enabledbooleandefault: truesecretstringBring your own signing secret (default: generated)
16–256 characters
Returns object
objectstringwebhook
idstringnamestringurlstringenabledbooleanall_eventsbooleaneventsarray of stringprofile_idsarray of string | nullsecretstringSigning secret. Only returned on create and reset-secret.
last_delivery_atstring (date-time) | nullfailure_countintegerdisabled_reasonstring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
{
"object": "webhook",
"id": "string",
"name": "string",
"url": "https://example.com",
"enabled": true,
"all_events": true,
"events": [
"string"
],
"profile_ids": [
"string"
],
"secret": "string",
"last_delivery_at": "2026-10-13T09:00:00.000Z",
"failure_count": 1,
"disabled_reason": "string",
"created_at": "2026-10-13T09:00:00.000Z",
"updated_at": "2026-10-13T09:00:00.000Z"
}Get a webhook
/webhooks/{id}Try it with MCPAsk your agent to call get-webhook (toolset webhooks)Set up MCP
Path parameters
idstringrequiredwebhook id (wh_…)
1–80 characters
Returns object
objectstringwebhook
idstringnamestringurlstringenabledbooleanall_eventsbooleaneventsarray of stringprofile_idsarray of string | nullsecretstringSigning secret. Only returned on create and reset-secret.
last_delivery_atstring (date-time) | nullfailure_countintegerdisabled_reasonstring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
{
"object": "webhook",
"id": "string",
"name": "string",
"url": "https://example.com",
"enabled": true,
"all_events": true,
"events": [
"string"
],
"profile_ids": [
"string"
],
"secret": "string",
"last_delivery_at": "2026-10-13T09:00:00.000Z",
"failure_count": 1,
"disabled_reason": "string",
"created_at": "2026-10-13T09:00:00.000Z",
"updated_at": "2026-10-13T09:00:00.000Z"
}Update a webhook
/webhooks/{id}Re-enabling a disabled webhook resets its failure streak.
Try it with MCPAsk your agent to call update-webhook (toolset webhooks)Set up MCP
Path parameters
idstringrequiredwebhook id (wh_…)
1–80 characters
Body object
namestring1–100 characters
urlstring8–2048 characters
eventsarray of string≤ 200 items · unique
all_eventsbooleanprofile_idsarray of string | null≤ 500 items
enabledbooleanReturns object
objectstringwebhook
idstringnamestringurlstringenabledbooleanall_eventsbooleaneventsarray of stringprofile_idsarray of string | nullsecretstringSigning secret. Only returned on create and reset-secret.
last_delivery_atstring (date-time) | nullfailure_countintegerdisabled_reasonstring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
{
"object": "webhook",
"id": "string",
"name": "string",
"url": "https://example.com",
"enabled": true,
"all_events": true,
"events": [
"string"
],
"profile_ids": [
"string"
],
"secret": "string",
"last_delivery_at": "2026-10-13T09:00:00.000Z",
"failure_count": 1,
"disabled_reason": "string",
"created_at": "2026-10-13T09:00:00.000Z",
"updated_at": "2026-10-13T09:00:00.000Z"
}Delete a webhook
/webhooks/{id}Try it with MCPAsk your agent to call delete-webhook (toolset webhooks)Set up MCP
Path parameters
idstringrequiredwebhook id (wh_…)
1–80 characters
Returns object
objectstringrequiredwebhook
idstringrequireddeletedbooleanrequiredResponses
{
"object": "webhook",
"id": "string",
"deleted": true
}Send a test event
/webhooks/{id}/testSends one signed sample event now and returns the receiver response. Not retried.
Try it with MCPAsk your agent to call test-webhook (toolset webhooks)Set up MCP
Path parameters
idstringrequiredwebhook id (wh_…)
1–80 characters
Body object
typestringSample event type (default webhook.test)
post.scheduledpost.publishingpost.publishedpost.partially_publishedpost.failedpost.deletedpost.unpublishedpost.cancelledpost.editedpost.recycledpost.approval_requestedpost.approvedpost.rejectedposting.publishedposting.failedaccount.connectedaccount.disconnectedaccount.needs_reconnectaccount.updatedmessage.receivedmessage.sentmessage.deliveredmessage.readmessage.failed+66 more
Returns object
objectstringwebhook_test
successbooleanstatus_codeinteger | nullduration_msinteger | nullresponse_bodystring | nullerrorstring | nulldeliveryobjectShow 15 child attributes
objectstringwebhook_delivery
idstringwebhook_idstringevent_idstring | nullevent_typestringattemptintegerstatusstringpendingdeliveredfailed
status_codeinteger | nullresponse_bodystring | nullerrorstring | nullduration_msinteger | nulltestbooleannext_retry_atstring (date-time) | nullcreated_atstring (date-time) | nulldelivered_atstring (date-time) | nullResponses
{
"object": "webhook_test",
"success": true,
"status_code": 1,
"duration_ms": 1,
"response_body": "string",
"error": "string",
"delivery": {
"object": "webhook_delivery",
"id": "string",
"webhook_id": "string",
"event_id": "string",
"event_type": "string",
"attempt": 1,
"status": "pending",
"status_code": 1,
"response_body": "string",
"error": "string",
"duration_ms": 1,
"test": true,
"next_retry_at": "2026-10-13T09:00:00.000Z",
"created_at": "2026-10-13T09:00:00.000Z",
"delivered_at": "2026-10-13T09:00:00.000Z"
}
}Rotate the signing secret
/webhooks/{id}/reset-secretTry it with MCPAsk your agent to call reset-webhook-secret (toolset webhooks)Set up MCP
Path parameters
idstringrequiredwebhook id (wh_…)
1–80 characters
Returns object
objectstringwebhook
idstringnamestringurlstringenabledbooleanall_eventsbooleaneventsarray of stringprofile_idsarray of string | nullsecretstringSigning secret. Only returned on create and reset-secret.
last_delivery_atstring (date-time) | nullfailure_countintegerdisabled_reasonstring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
{
"object": "webhook",
"id": "string",
"name": "string",
"url": "https://example.com",
"enabled": true,
"all_events": true,
"events": [
"string"
],
"profile_ids": [
"string"
],
"secret": "string",
"last_delivery_at": "2026-10-13T09:00:00.000Z",
"failure_count": 1,
"disabled_reason": "string",
"created_at": "2026-10-13T09:00:00.000Z",
"updated_at": "2026-10-13T09:00:00.000Z"
}List webhook deliveries
/webhooks/deliveriesDelivery log across every webhook of the workspace.
Try it with MCPAsk your agent to call list-all-webhook-deliveries (toolset webhooks)Set up MCP
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringcreated_atstatus_codeattempt
orderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
statusstringevent_typestringwebhook_idstringevent_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
objectstringwebhook_delivery
idstringwebhook_idstringevent_idstring | nullevent_typestringattemptintegerstatusstringpendingdeliveredfailed
status_codeinteger | nullresponse_bodystring | nullerrorstring | nullduration_msinteger | nulltestbooleannext_retry_atstring (date-time) | nullcreated_atstring (date-time) | nulldelivered_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
{
"object": "list",
"data": [
{
"object": "webhook_delivery",
"id": "string",
"webhook_id": "string",
"event_id": "string",
"event_type": "string",
"attempt": 1,
"status": "pending",
"status_code": 1,
"response_body": "string",
"error": "string",
"duration_ms": 1,
"test": true,
"next_retry_at": "2026-10-13T09:00:00.000Z",
"created_at": "2026-10-13T09:00:00.000Z",
"delivered_at": "2026-10-13T09:00:00.000Z"
}
],
"page": 1,
"limit": 1,
"total": 1,
"has_more": true,
"next_page_url": "https://example.com",
"previous_page_url": "https://example.com"
}Get a webhook delivery
/webhooks/deliveries/{id}Try it with MCPAsk your agent to call get-webhook-delivery (toolset webhooks)Set up MCP
Path parameters
idstringrequiredwebhookDelivery id (whd_…)
1–80 characters
Returns object
objectstringwebhook_delivery
idstringwebhook_idstringevent_idstring | nullevent_typestringattemptintegerstatusstringpendingdeliveredfailed
status_codeinteger | nullresponse_bodystring | nullerrorstring | nullduration_msinteger | nulltestbooleannext_retry_atstring (date-time) | nullcreated_atstring (date-time) | nulldelivered_atstring (date-time) | nullResponses
{
"object": "webhook_delivery",
"id": "string",
"webhook_id": "string",
"event_id": "string",
"event_type": "string",
"attempt": 1,
"status": "pending",
"status_code": 1,
"response_body": "string",
"error": "string",
"duration_ms": 1,
"test": true,
"next_retry_at": "2026-10-13T09:00:00.000Z",
"created_at": "2026-10-13T09:00:00.000Z",
"delivered_at": "2026-10-13T09:00:00.000Z"
}Redeliver an event
/webhooks/deliveries/{id}/redeliverQueues a new delivery of the same event to the same webhook.
Try it with MCPAsk your agent to call redeliver-webhook-delivery (toolset webhooks)Set up MCP
Path parameters
idstringrequiredwebhookDelivery id (whd_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringwebhook_delivery
idstringwebhook_idstringevent_idstring | nullevent_typestringattemptintegerstatusstringpendingdeliveredfailed
status_codeinteger | nullresponse_bodystring | nullerrorstring | nullduration_msinteger | nulltestbooleannext_retry_atstring (date-time) | nullcreated_atstring (date-time) | nulldelivered_atstring (date-time) | nullResponses
{
"object": "webhook_delivery",
"id": "string",
"webhook_id": "string",
"event_id": "string",
"event_type": "string",
"attempt": 1,
"status": "pending",
"status_code": 1,
"response_body": "string",
"error": "string",
"duration_ms": 1,
"test": true,
"next_retry_at": "2026-10-13T09:00:00.000Z",
"created_at": "2026-10-13T09:00:00.000Z",
"delivered_at": "2026-10-13T09:00:00.000Z"
}List a webhook's deliveries
/webhooks/{id}/deliveriesTry it with MCPAsk your agent to call list-webhook-deliveries (toolset webhooks)Set up MCP
Path parameters
idstringrequiredwebhook id (wh_…)
1–80 characters
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringcreated_atstatus_codeattempt
orderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
statusstringevent_typestringwebhook_idstringevent_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
objectstringwebhook_delivery
idstringwebhook_idstringevent_idstring | nullevent_typestringattemptintegerstatusstringpendingdeliveredfailed
status_codeinteger | nullresponse_bodystring | nullerrorstring | nullduration_msinteger | nulltestbooleannext_retry_atstring (date-time) | nullcreated_atstring (date-time) | nulldelivered_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
{
"object": "list",
"data": [
{
"object": "webhook_delivery",
"id": "string",
"webhook_id": "string",
"event_id": "string",
"event_type": "string",
"attempt": 1,
"status": "pending",
"status_code": 1,
"response_body": "string",
"error": "string",
"duration_ms": 1,
"test": true,
"next_retry_at": "2026-10-13T09:00:00.000Z",
"created_at": "2026-10-13T09:00:00.000Z",
"delivered_at": "2026-10-13T09:00:00.000Z"
}
],
"page": 1,
"limit": 1,
"total": 1,
"has_more": true,
"next_page_url": "https://example.com",
"previous_page_url": "https://example.com"
}Retry failed deliveries
/webhooks/{id}/retry-failedRe-queues failed deliveries from the last 3 days.
Try it with MCPAsk your agent to call retry-failed-webhook-deliveries (toolset webhooks)Set up MCP
Path parameters
idstringrequiredwebhook id (wh_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringwebhook_retry
webhook_idstringretriedintegerResponses
{
"object": "webhook_retry",
"webhook_id": "string",
"retried": 1
}