ZAzahlo
Webhooks

Rotate a webhook endpoint's signing secret

Rotate a webhook endpoint's signing secret. Use the response status and request ID to decide whether to retry, reconcile, or ask the customer for action.

post/api/v1/webhook-endpoints/{id}/rotate-secret

Request

  • Base URL
    https://merchant.zahlo.eu
  • Auth
    API key in header x-api-key

Path parameters

idstring required

The resource identifier returned by the merchant API.

Headers

Idempotency-Keystring

Retry-safe key for create operations.

Response

The endpoint with its new secret (shown once)

idstring required
object'webhook_endpoint' required
livemodeboolean required
createdAtstring date-time required
urlstring uri required
enabledEventsstring[] required
status'enabled' | 'disabled' required
descriptionstring nullable
metadataobject

Up to 50 key-value pairs; keys up to 40 characters, values strings up to 500 characters.

failingSincestring date-time nullable

Start of the current run of failed deliveries; null while healthy. After 3 days the endpoint is disabled.

disabledReason'failing' | 'null' nullable

failing when Zahlo disabled the endpoint after 3 days of failures.

secretstring

Only in the create and rotate-secret responses.

Changes

No recorded changes to this operation across all 1 revision of this API.