Actions41
- Contact Actions
- Conversation Actions
- Label Actions
- Message Actions
- Template Actions
- Webhook Delivery Actions
- Webhook Subscription Actions
Webhook Subscription → Revoke Secret
AI-generatedSummary
Permanently remove a specific webhook signing secret from a subscription, ensuring the subscription retains at least one active secret.
Inputs
- subscriptionId (required) — ID of the webhook subscription (e.g. wbs_…) to revoke the secret from.
- secretId (required) — ID of the specific secret to revoke (from the subscription's secrets array).
- requestOptions — Optional HTTP request settings including batching, SSL verification, proxy, and timeout.
Output shape
no body — success/failure only
The operation returns an empty body on success. The secret is permanently deleted; the subscription must have at least one remaining active secret.
Examples
Example 1: Rotate a webhook signing key for security
Revoke an old secret (sec_old) while a new one is still active, forcing your webhook endpoint to switch to the new key.