Skip to main content

Endpoint

Escopo necessário: write:webhooks

Corpo da requisição

Eventos disponíveis

São 47 eventos, em 13 grupos. A referência de eventos lista todos com o payload exato de cada um. Um evento fora da lista faz a requisição falhar com validation_error.
A URL precisa ser HTTPS e resolver para um endereço público. localhost, redes privadas e faixas reservadas são recusadas com 422 SSRF_BLOCKED, tanto aqui quanto no momento de cada entrega.

Exemplo de requisição

Exemplo de resposta

Retorna HTTP 201.
O campo secret é exibido apenas nesta resposta. Armazene-o imediatamente como variável de ambiente para usar na validação de assinaturas. Não é possível recuperá-lo depois.

Validando entregas

Use o secret para conferir a assinatura de cada requisição recebida. Os exemplos em Node, Python, PHP e Go estão em Segurança e verificação.

Erros