Pular para o conteúdo principal

Gerenciar Webhooks

Cadastrar webhook​

POST /v1/webhooks

{
  "url": "https://meuservidor.com/zemo/webhook",
  "events": ["operation.paid", "title.paid", "operation.cancelled"],
  "description": "Webhook principal producao"
}

Response 201​

{
  "id": "01970dc6-...",
  "url": "https://meuservidor.com/zemo/webhook",
  "events": ["operation.paid", "title.paid", "operation.cancelled"],
  "hmac_secret": "a1b2c3d4e5f6...64_chars_hex",
  "created_at": "2026-06-01T10:00:00Z"
}
Salve o HMAC secret

O hmac_secret e exibido apenas nesta resposta. Armazene-o em um cofre de segredos.

Listar webhooks​

GET /v1/webhooks

Ver entregas​

GET /v1/webhooks/{webhook_id}/deliveries

{
  "deliveries": [
    {
      "event_type": "operation.paid",
      "response_status_code": 200,
      "duration_ms": 145,
      "attempt_number": 1,
      "delivered_successfully": true,
      "created_at": "2026-06-01T15:30:01Z"
    }
  ]
}

Remover webhook​

DELETE /v1/webhooks/{webhook_id} — 204