Actions41
- Contact Actions
- Conversation Actions
- Label Actions
- Message Actions
- Template Actions
- Webhook Delivery Actions
- Webhook Subscription Actions
Webhook Subscription → Rotate Secret
AI-generatedSummary
Add a new signing secret to a webhook subscription by sending its ID and the requested lifetime in hours. The previous secret remains valid until it expires, providing time to update webhook signature verification.
Inputs
- Subscription ID (required) — ID of the webhook subscription to rotate (for example, wbs_…).
- Expires In (Hours) — Lifetime of the new secret in hours; defaults to 72 and accepts values from 1 to 336 (14 days).
Output shape
A single API response record containing the newly created secret.
The operation returns the new secret's plaintext only once; save it from this response for signature verification. The previous secret remains valid until its expiry. The node sends a POST request to the subscription's secrets endpoint.