> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socialsell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar webhooks

> Retorna todas as assinaturas de webhook da organização.

## Endpoint

```
GET /v1/webhooks
```

**Escopo necessário:** `read:webhooks` — disponível nos planos **Growth e Scale**

## Exemplo de requisição

```bash theme={null}
curl "https://api.socialsell.ai/v1/webhooks" \
  -H "Authorization: Bearer sk_live_..."
```

## Exemplo de resposta

```json theme={null}
{
  "data": [
    {
      "id": "664m8n9o0p1q2r3s4t5u6v7w",
      "name": "Notificações ERP",
      "url": "https://meusistema.com/webhook/socialsell",
      "events": ["contact.created", "deal.won", "deal.stage.changed"],
      "status": "active",
      "last_delivery_at": "2026-06-10T15:50:00.000Z",
      "last_failure_at": null,
      "consecutive_failures": 0,
      "created_at": "2026-05-01T10:00:00.000Z",
      "updated_at": "2026-06-10T15:50:00.000Z"
    }
  ],
  "meta": {
    "total": 2,
    "has_more": false
  }
}
```

## Objeto webhook

| Campo                  | Tipo         | Descrição                      |
| ---------------------- | ------------ | ------------------------------ |
| `id`                   | string       | ID da assinatura               |
| `name`                 | string       | Nome descritivo                |
| `url`                  | string       | URL de destino (HTTPS)         |
| `events`               | string\[]    | Eventos assinados              |
| `status`               | string       | `active` ou `paused`           |
| `last_delivery_at`     | string\|null | Última entrega bem-sucedida    |
| `last_failure_at`      | string\|null | Última falha de entrega        |
| `consecutive_failures` | integer      | Falhas consecutivas acumuladas |
| `created_at`           | string       | Timestamp de criação           |
| `updated_at`           | string       | Timestamp de atualização       |