Webhooks (v2)

Rotate a webhook signing secret

Rotate a signing secret for a specific webhook.

For more information, see the guides: About webhooks and Manage webhooks.

post/webhooks/{webhook_id}/rotate-signing-secret

Request

  • Base URL
    https://b2b.revolut.com/api/2.0
  • Auth
    HTTP bearer

Path parameters

webhook_idstring uuid required

The ID of the webhook for which to rotate the secret.

Request body

expiration_periodstring duration

The expiration period for the signing secret in ISO 8601 format. If set, when you rotate the secret, it continues to be valid until the expiration period has passed. Otherwise, on rotation, the secret is invalidated immediately. The maximum value is 7 days.

Example request

{
  "expiration_period": "PT5H30M"
}

Response

The details of the webhook for which you rotated the signing secret

idstring uuid required

The ID of the webhook.

urlstring uri required

The valid webhook URL that event notifications are sent to. The supported protocol is https.

eventsWebhookEventType[] required

The list of event types that you are subscribed to.

signing_secretstring required

The signing secret for the webhook.

Example response

{
  "id": "6fc346be-5cb5-4c14-aadc-e8aba6a655d7",
  "url": "https://www.example.com/",
  "events": [
    "TransactionCreated"
  ],
  "signing_secret": "wsk_4jETWMz1g1b37gCONjNp84t2KSSIT7dK"
}

Changes

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