Skip to content
Docs

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.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits12 endpointsMCP toolset webhooks

List webhooks

GET/webhooks

Access: adminZernio: GET /v1/webhooks/settings

Try it with MCPAsk your agent to call list-webhooks (toolset webhooks)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atnamelast_delivery_at

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

enabledstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 14 item attributes
objectstring

webhook

idstring
namestring
urlstring
enabledboolean
all_eventsboolean
eventsarray of string
profile_idsarray of string | null
secretstring

Signing secret. Only returned on create and reset-secret.

last_delivery_atstring (date-time) | null
failure_countinteger
disabled_reasonstring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/webhooks
curl "https://api.socialit.com/v1/webhooks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

POST/webhooks

The response contains the signing secret; it is only shown again after reset-secret.

Access: adminIdempotency-KeyZernio: POST /v1/webhooks/settings

Try it with MCPAsk your agent to call create-webhook (toolset webhooks)Set up MCP

Headers

Idempotency-Keystring

Unique 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

namestringrequired

1–100 characters

urlstringrequired

8–2048 characters

eventsarray of string

≤ 200 items · unique

all_eventsboolean
profile_idsarray of string | null

≤ 500 items

enabledbooleandefault: true
secretstring

Bring your own signing secret (default: generated)

16–256 characters

Returns object

objectstring

webhook

idstring
namestring
urlstring
enabledboolean
all_eventsboolean
eventsarray of string
profile_idsarray of string | null
secretstring

Signing secret. Only returned on create and reset-secret.

last_delivery_atstring (date-time) | null
failure_countinteger
disabled_reasonstring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/webhooks
curl -X POST "https://api.socialit.com/v1/webhooks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "url": "https://example.com",
    "events": [
      "*"
    ],
    "all_events": true,
    "profile_ids": [
      "string"
    ]
  }'
Response · 201
{
  "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

GET/webhooks/{id}

Access: admin

Try it with MCPAsk your agent to call get-webhook (toolset webhooks)Set up MCP

Path parameters

idstringrequired

webhook id (wh_…)

1–80 characters

Returns object

objectstring

webhook

idstring
namestring
urlstring
enabledboolean
all_eventsboolean
eventsarray of string
profile_idsarray of string | null
secretstring

Signing secret. Only returned on create and reset-secret.

last_delivery_atstring (date-time) | null
failure_countinteger
disabled_reasonstring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/webhooks/{id}
curl "https://api.socialit.com/v1/webhooks/wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

PATCH/webhooks/{id}

Re-enabling a disabled webhook resets its failure streak.

Access: adminZernio: PUT /v1/webhooks/settings

Try it with MCPAsk your agent to call update-webhook (toolset webhooks)Set up MCP

Path parameters

idstringrequired

webhook id (wh_…)

1–80 characters

Body object

namestring

1–100 characters

urlstring

8–2048 characters

eventsarray of string

≤ 200 items · unique

all_eventsboolean
profile_idsarray of string | null

≤ 500 items

enabledboolean

Returns object

objectstring

webhook

idstring
namestring
urlstring
enabledboolean
all_eventsboolean
eventsarray of string
profile_idsarray of string | null
secretstring

Signing secret. Only returned on create and reset-secret.

last_delivery_atstring (date-time) | null
failure_countinteger
disabled_reasonstring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/webhooks/{id}
curl -X PATCH "https://api.socialit.com/v1/webhooks/wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "url": "https://example.com",
    "events": [
      "*"
    ],
    "all_events": true,
    "profile_ids": [
      "string"
    ]
  }'
Response · 200
{
  "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

DELETE/webhooks/{id}

Access: adminZernio: DELETE /v1/webhooks/settings

Try it with MCPAsk your agent to call delete-webhook (toolset webhooks)Set up MCP

Path parameters

idstringrequired

webhook id (wh_…)

1–80 characters

Returns object

objectstringrequired

webhook

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/webhooks/{id}
curl -X DELETE "https://api.socialit.com/v1/webhooks/wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "webhook",
  "id": "string",
  "deleted": true
}

Send a test event

POST/webhooks/{id}/test

Sends one signed sample event now and returns the receiver response. Not retried.

Access: adminZernio: POST /v1/webhooks/test

Try it with MCPAsk your agent to call test-webhook (toolset webhooks)Set up MCP

Path parameters

idstringrequired

webhook id (wh_…)

1–80 characters

Body object

typestring

Sample 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

objectstring

webhook_test

successboolean
status_codeinteger | null
duration_msinteger | null
response_bodystring | null
errorstring | null
deliveryobject
Show 15 child attributes
objectstring

webhook_delivery

idstring
webhook_idstring
event_idstring | null
event_typestring
attemptinteger
statusstring

pendingdeliveredfailed

status_codeinteger | null
response_bodystring | null
errorstring | null
duration_msinteger | null
testboolean
next_retry_atstring (date-time) | null
created_atstring (date-time) | null
delivered_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/webhooks/{id}/test
curl -X POST "https://api.socialit.com/v1/webhooks/wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/test" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "post.scheduled"
  }'
Response · 200
{
  "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

POST/webhooks/{id}/reset-secret

Access: admin

Try it with MCPAsk your agent to call reset-webhook-secret (toolset webhooks)Set up MCP

Path parameters

idstringrequired

webhook id (wh_…)

1–80 characters

Returns object

objectstring

webhook

idstring
namestring
urlstring
enabledboolean
all_eventsboolean
eventsarray of string
profile_idsarray of string | null
secretstring

Signing secret. Only returned on create and reset-secret.

last_delivery_atstring (date-time) | null
failure_countinteger
disabled_reasonstring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/webhooks/{id}/reset-secret
curl -X POST "https://api.socialit.com/v1/webhooks/wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reset-secret" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/webhooks/deliveries

Delivery log across every webhook of the workspace.

Access: adminZernio: GET /v1/webhooks/logs

Try it with MCPAsk your agent to call list-all-webhook-deliveries (toolset webhooks)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atstatus_codeattempt

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

statusstring
event_typestring
webhook_idstring
event_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
objectstring

webhook_delivery

idstring
webhook_idstring
event_idstring | null
event_typestring
attemptinteger
statusstring

pendingdeliveredfailed

status_codeinteger | null
response_bodystring | null
errorstring | null
duration_msinteger | null
testboolean
next_retry_atstring (date-time) | null
created_atstring (date-time) | null
delivered_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/webhooks/deliveries
curl "https://api.socialit.com/v1/webhooks/deliveries" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

GET/webhooks/deliveries/{id}

Access: admin

Try it with MCPAsk your agent to call get-webhook-delivery (toolset webhooks)Set up MCP

Path parameters

idstringrequired

webhookDelivery id (whd_…)

1–80 characters

Returns object

objectstring

webhook_delivery

idstring
webhook_idstring
event_idstring | null
event_typestring
attemptinteger
statusstring

pendingdeliveredfailed

status_codeinteger | null
response_bodystring | null
errorstring | null
duration_msinteger | null
testboolean
next_retry_atstring (date-time) | null
created_atstring (date-time) | null
delivered_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/webhooks/deliveries/{id}
curl "https://api.socialit.com/v1/webhooks/deliveries/whd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

POST/webhooks/deliveries/{id}/redeliver

Queues a new delivery of the same event to the same webhook.

Access: adminIdempotency-KeyZernio: POST /v1/webhooks/logs/redeliver

Try it with MCPAsk your agent to call redeliver-webhook-delivery (toolset webhooks)Set up MCP

Path parameters

idstringrequired

webhookDelivery id (whd_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstring

webhook_delivery

idstring
webhook_idstring
event_idstring | null
event_typestring
attemptinteger
statusstring

pendingdeliveredfailed

status_codeinteger | null
response_bodystring | null
errorstring | null
duration_msinteger | null
testboolean
next_retry_atstring (date-time) | null
created_atstring (date-time) | null
delivered_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/webhooks/deliveries/{id}/redeliver
curl -X POST "https://api.socialit.com/v1/webhooks/deliveries/whd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/redeliver" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
Response · 201
{
  "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

GET/webhooks/{id}/deliveries

Access: admin

Try it with MCPAsk your agent to call list-webhook-deliveries (toolset webhooks)Set up MCP

Path parameters

idstringrequired

webhook id (wh_…)

1–80 characters

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atstatus_codeattempt

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

statusstring
event_typestring
webhook_idstring
event_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
objectstring

webhook_delivery

idstring
webhook_idstring
event_idstring | null
event_typestring
attemptinteger
statusstring

pendingdeliveredfailed

status_codeinteger | null
response_bodystring | null
errorstring | null
duration_msinteger | null
testboolean
next_retry_atstring (date-time) | null
created_atstring (date-time) | null
delivered_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/webhooks/{id}/deliveries
curl "https://api.socialit.com/v1/webhooks/wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/deliveries" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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

POST/webhooks/{id}/retry-failed

Re-queues failed deliveries from the last 3 days.

Access: adminIdempotency-Key

Try it with MCPAsk your agent to call retry-failed-webhook-deliveries (toolset webhooks)Set up MCP

Path parameters

idstringrequired

webhook id (wh_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstring

webhook_retry

webhook_idstring
retriedinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/webhooks/{id}/retry-failed
curl -X POST "https://api.socialit.com/v1/webhooks/wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/retry-failed" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
Response · 200
{
  "object": "webhook_retry",
  "webhook_id": "string",
  "retried": 1
}