Skip to main content

Rotate the signing secret for a number

POST 
/api/v1/waba/webhook-secrets/:phoneNumberId/rotate

The secret that signs your webhook deliveries is per number, not per project, and is not your API key. The new one is returned once and cannot be read back. Deliveries already queued were signed with the previous secret, so accept both for a few minutes after rotating. Every 90 days is a reasonable cadence.

Request​

Responses​

Webhook secret rotated successfully