---
title: "Criar um webhook"
method: POST
path: "/webhooks/create"
---

# Criar um webhook

`POST /webhooks/create`

Cria um novo webhook para receber notificações automáticas de eventos da sua loja.

O `endpoint` deve ser uma URL HTTPS válida e não pode apontar para endereços locais ou IPs privados.

**Alternativa**: Você também pode criar e gerenciar seus webhooks pelo [Dashboard da AbacatePay](https://app.abacatepay.com/webhooks).

## Request body

- WebhookCreateInput — Dados para criação de um webhook.
  - `name` string, required — Nome identificador do webhook
  - `endpoint` string, required — URL HTTPS que receberá as notificações de eventos
  - `secret` string, required — Sua chave usada para autenticar nosso webhook
  - `events` string[], required — Lista de eventos que este webhook deve receber

## Response `200`

Webhook criado com sucesso.

- object
  - `data` WebhookResponse — Os dados do webhook.
    - `id` string, required — Identificador único do webhook
    - `name` string, required — Nome identificador do webhook
    - `endpoint` string, required — URL HTTPS que recebe as notificações de eventos
    - `events` string[], required — Lista de eventos subscritos
    - `devMode` boolean, required — Indica se o webhook foi criado em ambiente de testes
    - `v2` boolean, required — Indica se o webhook usa o formato de payload v2
    - `createdAt` string, date-time, required — Data de criação do webhook
    - `updatedAt` string, date-time, required — Data da última atualização do webhook
  - `error` string, nullable
  - `success` boolean — Se a requisição obteve sucesso ou não.

## Other responses

- `401` — Não autorizado. Falha na autenticação.

---

[API](https://skmtc.net/abacatepay/apis/api-abacatepay.md) · [All operations](https://skmtc.net/abacatepay/apis/api-abacatepay/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/abacatepay/api-abacatepay/revisions/6b89a7fa70f5/schema)