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. vk_live_… es una llave real; vk_test_…, una llave de modo prueba (verificaciones simuladas, nada toca el libro real). Ver la guía «Modo de prueba».

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; 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"}