Webhooks

Rotate webhook signing secret

Generates a new signing secret for the specified webhook. The old secret is immediately invalidated.

post/v3/webhooks/{id}/rotate-secret

Path parameters

idstring uuid required

Headers

Idempotency-Keystring

Unique key to ensure idempotent request processing. Must be 1-255 alphanumeric characters, hyphens, or underscores. Responses are cached for 24 hours per key per customer.

x-profile-idstring uuid

Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.

Request body

sandboxboolean

Sandbox flag - when true, the operation is simulated without side effects Useful for testing integrations without actual execution

Response

Secret rotated successfully

successboolean

Indicates whether the request was successful

Changes

No recorded changes to this endpoint across all 50 revisions of this API.