---
title: "Get Webhook"
method: GET
path: "/webhooks/{webhookId}"
tags: ["Webhooks"]
---

# Get Webhook

`GET /webhooks/{webhookId}`

## Request

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

Retrieve details of a single webhook including its status, event types, and delivery information.

## Path parameters

- `webhookId` string, required

## Response `200`

Webhook retrieved successfully

- ShowWebhookResponse: Response containing a single webhook
  - `message` string, required: Human-readable response message
  - `data` WebhookView, required: View of a webhook
    - `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
- `404`: Webhook not found
- `500`: Server error - Failed to retrieve webhook
- `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)