Webhooks

API reference descriptions are provided in English to preserve the exact published contract.

POSTRedeliver a selection of retained eventspostV1AccountsByAcEventsRedeliver
POSTRedeliver a retained event to its subscribed endpointspostV1AccountsByAcEventsByEvRedeliver
GETList webhook deliveries for one retained resourcewebhookDeliveries.list
GETList the event types a webhook endpoint can subscribe towebhookEventTypes.list
GETList customer webhook endpointswebhooks.list
POSTCreate a customer webhook endpointwebhooks.create
GETFetch a customer webhook endpointwebhooks.retrieve
PATCHUpdate a customer webhook endpointwebhooks.update
DELETEDisable a customer webhook endpointwebhooks.delete
GETList webhook delivery historywebhooks.deliveries.list
POSTRetry queued or failed webhook deliveries, oldest firstpostV1AccountsByAcWebhooksByWhDeliveriesRetry
GETFetch webhook delivery request and attempt historywebhooks.deliveries.retrieve
POSTRedeliver a retained event without reprocessing its resourcepostV1AccountsByAcWebhooksByWhDeliveriesByWdRetry
GETRead authoritative retained delivery totalswebhooks.deliverySummary.list
POSTPause endpoint deliverywebhooks.pause
POSTResume endpoint deliverywebhooks.resume
POSTEnd the signing-secret rotation overlap immediatelywebhooks.secret.endOverlap
POSTRotate the endpoint signing secret with overlapwebhooks.secret.rotate
POSTSend a signed test.ping eventwebhooks.test
POSTVerify endpoint ownership and activate deliverywebhooks.verify

Redeliver a selection of retained events

POST/v1/accounts/{AC}/events/redeliver

postV1AccountsByAcEventsRedeliverSDK operation postV1AccountsByAcEventsRedeliver

Required scope: webhooks:write.Idempotency-Key required

Request body

eventSidsstring (EV… SID)[]Required
endpointSidstring (WH… SID)

POST /v1/accounts/{AC}/events/redeliver

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/events/redeliver" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "eventSids": "EV..."
}'

Responses

Redeliver a retained event to its subscribed endpoints

POST/v1/accounts/{AC}/events/{EV}/redeliver

postV1AccountsByAcEventsByEvRedeliverSDK operation postV1AccountsByAcEventsByEvRedeliver

Send a retained event again, to every subscribed endpoint or to one with endpointSid.

Required scope: webhooks:write.Idempotency-Key required

Parameters

EVstring (EV… SID)Required

Request body

endpointSidstring (WH… SID)

POST /v1/accounts/{AC}/events/{EV}/redeliver

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/events/EV.../redeliver" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

List webhook deliveries for one retained resource

GET/v1/accounts/{AC}/webhook-deliveries

webhookDeliveries.listSDK operation getV1AccountsByAcWebhookDeliveries

Required scope: webhooks:read.Paginated

Parameters

resourceSidstring (max 128 chars)queryRequired
limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/webhook-deliveries

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhook-deliveries?resourceSid=string" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

List the event types a webhook endpoint can subscribe to

GET/v1/accounts/{AC}/webhook-event-types

webhookEventTypes.listSDK operation getV1AccountsByAcWebhookEventTypes

Required scope: webhooks:read.

GET /v1/accounts/{AC}/webhook-event-types

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhook-event-types" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

List customer webhook endpoints

GET/v1/accounts/{AC}/webhooks

webhooks.listSDK operation getV1AccountsByAcWebhooks

List your webhook endpoints with their verification and delivery state.

Required scope: webhooks:read.Paginated

Parameters

limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/webhooks

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Create a customer webhook endpoint

POST/v1/accounts/{AC}/webhooks

webhooks.createSDK operation postV1AccountsByAcWebhooks

Required scope: webhooks:write.Idempotency-Key required

Request body

urlstring (uri, max 2048 chars)Required
apiVersionstring (pattern ^\d{4}-\d{2}-\d{2}$)
concurrencyCapinteger (1–256)
eventFiltersstring (max 128 chars)[]
stepUpTokenstring (max 256 chars)
timeoutMsinteger (1000–30000)

POST /v1/accounts/{AC}/webhooks

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "string"
}'

Responses

Fetch a customer webhook endpoint

GET/v1/accounts/{AC}/webhooks/{WH}

webhooks.retrieveSDK operation getV1AccountsByAcWebhooksByWh

Required scope: webhooks:read.

Parameters

WHstring (WH… SID)Required

GET /v1/accounts/{AC}/webhooks/{WH}

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Update a customer webhook endpoint

PATCH/v1/accounts/{AC}/webhooks/{WH}

webhooks.updateSDK operation patchV1AccountsByAcWebhooksByWh

Change an endpoint's URL, event filters, timeout or concurrency.

Required scope: webhooks:write.Idempotency-Key required

Parameters

WHstring (WH… SID)Required

Request body

apiVersionstring (pattern ^\d{4}-\d{2}-\d{2}$)
concurrencyCapinteger (1–256)
eventFiltersstring (max 128 chars)[]
stepUpTokenstring (max 256 chars)
timeoutMsinteger (1000–30000)
urlstring (uri, max 2048 chars)

PATCH /v1/accounts/{AC}/webhooks/{WH}

curl -X PATCH "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Disable a customer webhook endpoint

DELETE/v1/accounts/{AC}/webhooks/{WH}

webhooks.deleteSDK operation deleteV1AccountsByAcWebhooksByWh

Required scope: webhooks:write.

Parameters

WHstring (WH… SID)Required

DELETE /v1/accounts/{AC}/webhooks/{WH}

curl -X DELETE "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

List webhook delivery history

GET/v1/accounts/{AC}/webhooks/{WH}/deliveries

webhooks.deliveries.listSDK operation getV1AccountsByAcWebhooksByWhDeliveries

Required scope: webhooks:read.Paginated

Parameters

WHstring (WH… SID)Required
limitinteger (1–100)query
cursorstring (max 2048 chars)query
sortenumquery
createdAt-createdAt
resourceSidstring (max 128 chars)query
eventIdstring (EV… SID)query

GET /v1/accounts/{AC}/webhooks/{WH}/deliveries

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../deliveries" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Retry queued or failed webhook deliveries, oldest first

POST/v1/accounts/{AC}/webhooks/{WH}/deliveries/retry

postV1AccountsByAcWebhooksByWhDeliveriesRetrySDK operation postV1AccountsByAcWebhooksByWhDeliveriesRetry

Required scope: webhooks:write.Idempotency-Key required

Parameters

WHstring (WH… SID)Required

Request body

deliverySidsstring (WD… SID)[]
stateenum
pendingfailed

POST /v1/accounts/{AC}/webhooks/{WH}/deliveries/retry

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../deliveries/retry" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Fetch webhook delivery request and attempt history

GET/v1/accounts/{AC}/webhooks/{WH}/deliveries/{WD}

webhooks.deliveries.retrieveSDK operation getV1AccountsByAcWebhooksByWhDeliveriesByWd

Required scope: webhooks:read.

Parameters

WHstring (WH… SID)Required
WDstring (WD… SID)Required

GET /v1/accounts/{AC}/webhooks/{WH}/deliveries/{WD}

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../deliveries/WD..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Redeliver a retained event without reprocessing its resource

POST/v1/accounts/{AC}/webhooks/{WH}/deliveries/{WD}/retry

postV1AccountsByAcWebhooksByWhDeliveriesByWdRetrySDK operation postV1AccountsByAcWebhooksByWhDeliveriesByWdRetry

Required scope: webhooks:write.Idempotency-Key required

Parameters

WHstring (WH… SID)Required
WDstring (WD… SID)Required

POST /v1/accounts/{AC}/webhooks/{WH}/deliveries/{WD}/retry

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../deliveries/WD.../retry" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Read authoritative retained delivery totals

GET/v1/accounts/{AC}/webhooks/{WH}/delivery-summary

webhooks.deliverySummary.listSDK operation getV1AccountsByAcWebhooksByWhDeliverySummary

Required scope: webhooks:read.

Parameters

WHstring (WH… SID)Required

GET /v1/accounts/{AC}/webhooks/{WH}/delivery-summary

curl "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../delivery-summary" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Pause endpoint delivery

POST/v1/accounts/{AC}/webhooks/{WH}/pause

webhooks.pauseSDK operation postV1AccountsByAcWebhooksByWhPause

Required scope: webhooks:write.Idempotency-Key required

Parameters

WHstring (WH… SID)Required

POST /v1/accounts/{AC}/webhooks/{WH}/pause

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../pause" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Resume endpoint delivery

POST/v1/accounts/{AC}/webhooks/{WH}/resume

webhooks.resumeSDK operation postV1AccountsByAcWebhooksByWhResume

Required scope: webhooks:write.Idempotency-Key required

Parameters

WHstring (WH… SID)Required

POST /v1/accounts/{AC}/webhooks/{WH}/resume

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../resume" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

End the signing-secret rotation overlap immediately

POST/v1/accounts/{AC}/webhooks/{WH}/secret/end-overlap

webhooks.secret.endOverlapSDK operation postV1AccountsByAcWebhooksByWhSecretEndOverlap

Expires the previous signing secret now. Deliveries stop carrying its v1= signature, so any integration still verifying with the old secret fails from this moment.

Required scope: webhooks:write.Idempotency-Key required

Parameters

WHstring (WH… SID)Required

POST /v1/accounts/{AC}/webhooks/{WH}/secret/end-overlap

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../secret/end-overlap" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Rotate the endpoint signing secret with overlap

POST/v1/accounts/{AC}/webhooks/{WH}/secret/rotate

webhooks.secret.rotateSDK operation postV1AccountsByAcWebhooksByWhSecretRotate

Issue a new signing secret. The old one keeps signing alongside it until expiresAt, so you can deploy the new one without dropping events.

Required scope: webhooks:write.Idempotency-Key required

Parameters

WHstring (WH… SID)Required

Request body

expiresAtstring (date-time)
stepUpTokenstring (max 256 chars)

POST /v1/accounts/{AC}/webhooks/{WH}/secret/rotate

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../secret/rotate" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Send a signed test.ping event

POST/v1/accounts/{AC}/webhooks/{WH}/test

webhooks.testSDK operation postV1AccountsByAcWebhooksByWhTest

Send a signed test.ping event to the endpoint and report how it answered.

Required scope: webhooks:write.Idempotency-Key required

Parameters

WHstring (WH… SID)Required

POST /v1/accounts/{AC}/webhooks/{WH}/test

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../test" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Verify endpoint ownership and activate delivery

POST/v1/accounts/{AC}/webhooks/{WH}/verify

webhooks.verifySDK operation postV1AccountsByAcWebhooksByWhVerify

Required scope: webhooks:write.Idempotency-Key required

Parameters

WHstring (WH… SID)Required

POST /v1/accounts/{AC}/webhooks/{WH}/verify

curl -X POST "https://api.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/webhooks/WH.../verify" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses