MOmonaco
Webhooks

Rotate a Webhook Signing Secret

Changed on

Replaces the signing secret and returns the new one once. The old secret stops working immediately, and a delivery already in flight was signed with it, so accept both signatures on the receiver until traffic has settled.

Error codes

error.codeHTTPCauseWhat to do
not_found422No subscription with this id exists in the calling org.Check the id; a deleted subscription is never returned.
post/v1/webhooks/subscriptions/{subscription_id}/rotate-secret

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/webhooks/subscriptions/{subscription_id}/rotate-secret
  • Auth
    none declared

Path parameters

subscription_idstring uuid required

Response

Successful Response

Example response

{
  "data": {
    "secret": "whsec_..."
  }
}

Changes