VerifikaDocs
ReferenciaWebhooks

Rotar el secreto de firma

Durante 24 horas firmamos cada entrega con los dos secretos, así despliegas el nuevo cuando quieras sin perder un solo evento.

POST
/webhook-endpoints/{id}/rotate-secret

Autorización

apiKey webhooks.write
AutorizaciónBearer <token>

La llave del negocio, creada en el panel: Integraciones → API pública. Formato vk_live_… (o vk_test_… fuera de producción).

Va en: header

Permiso: webhooks.write

Parámetros de la ruta

id*string

Parámetros de consulta

companyId?string

Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios (plan Multi); con uno solo, se deduce.

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/webhook-endpoints/string/rotate-secret"
{  "object": "webhookSecret",  "secret": "whsec_y_Jr...",  "previousValidUntil": "2026-09-06T01:16:38.668Z"}