# List Webhooks

`GET /api/webhooks`

List all configured webhooks. Secrets are never returned (has_secret flag only). Supports page/per_page, sort, fields and date filters.

- **Group:** Webhooks
- **Since:** v3.0.0
- **Authentication:** `authtoken` header, created under Setup > API > API Management
- **HTML version:** /apiguide/webhooks/get-webhooks/

## Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `authtoken` | String | **required** | Authentication token, generated from admin area |

## Example request

```bash
curl -X GET "https://yoursite.com/api/webhooks" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Success response

### Success-Response:

```json
HTTP/1.1 200 OK
{
  "data": [
    {
      "id": "3",
      "name": "Order sync",
      "url": "https://hooks.example.com/perfex",
      "events": ["invoice_created", "invoice_paid"],
      "active": "1",
      "headers": { "X-Env": "prod" },
      "timeout": "30",
      "retry_count": "3",
      "last_triggered": "2026-07-20 14:32:10",
      "success_count": "128",
      "failure_count": "2",
      "date_created": "2026-02-14 09:12:44",
      "date_updated": "2026-07-20 14:32:10",
      "has_secret": true
    },
    {
      "id": "4",
      "name": "Ticket alerts",
      "url": "https://ops.example.com/webhooks/tickets",
      "events": ["ticket_created", "ticket_reply_created"],
      "active": "0",
      "headers": null,
      "timeout": "30",
      "retry_count": "5",
      "last_triggered": null,
      "success_count": "0",
      "failure_count": "0",
      "date_created": "2026-06-01 08:00:00",
      "date_updated": "2026-06-01 08:00:00",
      "has_secret": false
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 2,
    "total_pages": 1,
    "has_more": false,
    "current_page": 1,
    "last_page": 1
  }
}
```

---

Perfex CRM REST API by Themesic Interactive. Full reference: /apiguide/