---
title: "List Webhooks"
method: GET
path: "/webhooks"
tags: ["Webhooks"]
---

# List Webhooks

`GET /webhooks`

## Request

- Base URL: `https://app.lettr.com/api`
- URL: `https://app.lettr.com/api/webhooks`
- Auth: HTTP bearer

Retrieve all webhooks configured for your account. Returns webhooks with their current status, event types, and delivery information.

## Response `200`

List of webhooks retrieved successfully

- ListWebhooksResponse: Response containing a list of webhooks
  - `message` string, required: Human-readable response message
  - `data` object, required
    - `webhooks` WebhookView[], required: List of webhooks
      - `id` string, required: Unique identifier for the webhook
      - `name` string, required: Name of the webhook
      - `url` string, uri, required: URL where webhook events will be sent
      - `enabled` boolean, required: Whether the webhook is enabled
      - `event_types` string[], nullable: Specific event types the webhook receives (null if all events)
      - `auth_type` string, required: Authentication type for the webhook (none, basic, oauth2)
      - `has_auth_credentials` boolean, required: Whether authentication credentials are configured
      - `last_successful_at` string, date-time, nullable: Timestamp of the last successful webhook delivery
      - `last_failure_at` string, date-time, nullable: Timestamp of the last failed webhook delivery
      - `last_status` 'success' | 'failure' | 'null', nullable: Status of the last delivery attempt (success or failure)

## Other responses

- `401`: Unauthorized - Missing or invalid API key
- `500`: Server error - Failed to retrieve webhooks
- `503`: Service unavailable - the API key could not be verified, so the request was not processed. This does not mean the key is invalid; retry after the delay given in the Retry-After header.

---

[API](https://skmtc.dev/lettr/apis/lettr-api.md) · [All operations](https://skmtc.dev/lettr/apis/lettr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lettr/apis/lettr-api/revisions/48ef0dac1ebd?raw)