Finalize a webhook secret rotation

​

Promote the staged next secret to the sole signing secret and retire the old one. Call this after a graceful rotation once you have switched your verifier to the new secret — deliveries then sign with only the new secret. Returns 404 if the endpoint has no rotation in progress.

Path Parameters
  • id
    Type: string Format: uuid
    required
Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/v1/webhooks/endpoints/{id}/rotate-secret/promote
curl https://api.bettermoney.com/api/v1/webhooks/endpoints/123e4567-e89b-12d3-a456-426614174000/rotate-secret/promote \
  --request POST

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "url": "https://example.com",
  "description": null,
  "status": "ENABLED",
  "eventTypes": [
    "payment_order"
  ],
  "consecutiveFailures": -9007199254740991,
  "createdAt": "2026-09-08T20:57:50.016Z",
  "updatedAt": "2026-09-08T20:57:50.016Z",
  "disabledAt": null,
  "deletedAt": null
}

Default Response