---
title: "Get webhook"
method: GET
path: "/v1/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Get webhook

`GET /v1/webhooks/{webhook_id}`

## Request

- Base URL: `https://api.deadsimple.email`
- URL: `https://api.deadsimple.email/v1/webhooks/{webhook_id}`
- Auth: HTTP bearer

## Path parameters

- `webhook_id` string, required

## Response `200`

Webhook (signing secret never returned; header values masked)

- Webhook
  - `webhook_id` string, uuid
  - `workspace_id` string, uuid
  - `url` string, uri
  - `events` string[]
  - `is_active` boolean
  - `headers` object: Custom delivery headers, values masked (write-only).
  - `endpoint_secret_set` boolean: True when deliveries are also signed with the receiver's own Standard Webhooks secret (see endpoint_secret on create). The secret itself is write-only and never returned.
  - `inbox_ids` string[]: Inboxes this webhook is restricted to. Empty means every inbox.
  - `created_at` string, date-time

## Other responses

- `404`: No such webhook on this account

---

[API](https://skmtc.dev/deadsimple/apis/dead-simple-email-api.md) · [All operations](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/revisions/c697881be131?raw)