# List webhook endpoints

Retrieve all configured webhook endpoints for your account.

Tier Limits:
- Starter: 1 webhook endpoint
- Professional: 3 webhook endpoints
- Business: 10 webhook endpoints
- Custom: Configurable limit

Endpoint: GET /api/v1/customer/webhooks
Version: 1.0.0
Security: ApiKeyAuth

## Response 200 fields (application/json):

  - `webhooks` (array)

  - `webhooks.id` (string)
    Webhook endpoint ID

  - `webhooks.customer_id` (string)
    Customer ID

  - `webhooks.domain_ids` (array,null)
    Array of domain UUIDs this webhook receives events from.
- If null or empty: webhook is customer-level (receives events from ALL domains)
- If array with UUIDs: webhook receives events from those specific domains
    Example: ["550e8400-e29b-41d4-a716-446655440001","550e8400-e29b-41d4-a716-446655440002"]

  - `webhooks.domains` (array)
    Array of domain objects with id and domain name
    Example: [{"id":"550e8400-e29b-41d4-a716-446655440001","domain":"marketing.example.com"},{"id":"550e8400-e29b-41d4-a716-446655440002","domain":"campaigns.example.com"}]

  - `webhooks.domains.id` (string)

  - `webhooks.domains.domain` (string)

  - `webhooks.name` (string,null)
    Optional webhook identifier
    Example: "Production Webhook"

  - `webhooks.url` (string)
    HTTPS URL for webhook delivery
    Example: "https://api.example.com/webhooks/email-events"

  - `webhooks.description` (string,null)
    Optional notes about this webhook
    Example: "Main production webhook for email events"

  - `webhooks.events` (array)
    Event types this webhook receives
    Enum: "email.sent", "email.delivered", "email.opened", "email.clicked", "email.bounced", "email.complained", "email.unsubscribed", "email.failed"

  - `webhooks.is_active` (boolean)
    Whether webhook is enabled

  - `webhooks.last_triggered_at` (string,null)
    Timestamp of last webhook delivery

  - `webhooks.last_status` (integer,null)
    HTTP status code from last delivery
    Example: 200

  - `webhooks.created_at` (string)
    When webhook was created

  - `webhooks.updated_at` (string)
    When webhook was last updated

  - `limit` (integer)
    Maximum webhook endpoints allowed
    Example: 10

  - `used` (integer)
    Number of webhooks currently configured
    Example: 3

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message