sendsend.email

Rotate the signing secret

POST/v1/webhooks/{id}/rotate-secret

Issues a new secret, shown once. The old secret keeps signing alongside the new one for 24 hours so you can switch over without dropping events.

Required scope: webhooks:manage

Parameters

NameInDescription
idrequiredpathThe webhook endpoint id.

Example

curl -X POST 'https://api.sendsend.email/v1/webhooks/ID/rotate-secret' \
  -H "Authorization: Bearer $SENDSEND_API_KEY"

Response 200

{
  "id": "whe_3Hq…",
  "secret": "whsec_…",
  "previous_secret_valid_for_hours": 24
}

Errors

StatusCodeWhen
404not_foundNo such resource in this project.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.