Sign in
Webhooks

Rotate webhook endpoint signing secret

Changed on

Replace the endpoint's signing secret and return the new one. The old secret stops working immediately, so update your receiver right away. Returns 400 when signing is disabled. Not available to OAuth applications.

Copy as Markdown Open in ChatGPT Open in Claude

post/v1/accounts/{accountId}/webhooks/endpoints/{endpointId}/secret/rotate

Request

  • Base URL: https://api.assinafy.com.br
  • URL: https://api.assinafy.com.br/v1/accounts/{accountId}/webhooks/endpoints/{endpointId}/secret/rotate
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Path parameters

accountIdstring required

Workspace account ID.

endpointIdstring required

The webhook endpoint ID.

Response

The new secret

statusinteger

HTTP status code, mirrored in the body.

messagestring

Human-readable message; empty on success.

Example response

{
  "status": 200,
  "data": {
    "secret": "whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw"
  }
}

Changes