# Criar webhook

Receba eventos assinados no seu servidor.

POST`/webhooks/create`

Try it

## Corpo da requisição

[url](#request-url)stringrequired

URL HTTPS de um domínio público, sem porta personalizada ou credenciais.

[events](#request-events)string[]required

Eventos que este endpoint receberá.

[description](#request-description)string

Descrição que identifica a operação.

## Autorização

[X-API-Key](#auth-X-API-Key)stringrequired

Chave VibeCash com permissão para esta operação.

## Resposta

201 application/json

[success](#response-success)booleanrequired

Indica se a operação foi concluída pela API.

[message](#response-message)stringrequired

Mensagem da operação.

[data](#response-data)objectrequired

Dados retornados pela operação.

Show child attributes[item](#response-data-item)object

Endpoint cadastrado.

[secret](#response-data-secret)string

Segredo HMAC exibido uma única vez.

[requestId](#response-requestId)string

Identificador da requisição.

## Erros

As falhas retornam o envelope com `success: false`. Consulte [erros e códigos HTTP](/docs/api-reference/guides/errors) para interpretar validação, permissão, conflito e saldo insuficiente.

## Exemplo de requisição

```bash
curl --request POST \
  --url 'https://seu-dominio/v1/webhooks/create' \
  --header 'X-API-Key: tp_live_SUA_CHAVE' \
  --header 'Content-Type: application/json' \
  --data '{"url":"https://seu-dominio.com/webhook","events":["payment.paid","withdrawal.completed"],"description":"Minha integração"}'
```

## Exemplo de resposta

```json
{
  "success": true,
  "message": "Operação concluída",
  "data": {
    "item": {
      "id": "wh_exemplo",
      "url": "https://seu-dominio.com/webhook",
      "events": [
        "payment.paid"
      ],
      "status": "Ativo"
    },
    "secret": "SEGREDO_EXIBIDO_UMA_VEZ"
  },
  "requestId": "req_exemplo"
}
```
