# Read the domain's event webhook

The domain-scope event webhook: every mailbox whose primary address is on the domain feeds it, plus the domain's directory lifecycle and send outcomes. The signing secret is write-only.

## `GET /api/v1/domains/{domain}/event-webhook`

### Path parameters

- `domain` (string, required) — Domain name

### Responses

**200** — The hook

`application/json` → EventWebhook

- `consecutiveFailures` (integer, required) — Consecutive delivery failures; reset by any success or PUT
- `createdAt` (integer <int64>, required) — Creation timestamp in epoch seconds
- `disabledReason` (string | null, required) — 'failing' after the 24h auto-disable; any PUT re-enables
- `enabled` (boolean, required)
- `failingSince` (integer | null, required) — When the current failing streak began, epoch seconds
- `hasSecret` (boolean, required) — Whether a signing secret is set (write-only)
- `lastDeliveredAt` (integer | null, required) — Last successful delivery, epoch seconds
- `lastFailure` (string | null, required)
- `lastFailureAt` (integer | null, required) — Last failed delivery, epoch seconds
- `scope` ("mailbox" | "domain", required)
- `updatedAt` (integer <int64>, required) — Last update timestamp in epoch seconds
- `url` (string, required)
- `degraded` (boolean) — Platform domains only: true while attempts above the hook's supported rate are queued on their retry ladder (never dropped). The health fields of a platform hook are a projection published at a fixed cadence of about a minute
- `domain` (string) — Present on the domain scope
- `mailboxId` (string) — Present on the mailbox scope
- `retryAfter` (integer | null) — Platform domains only: when the degraded hook has room again, epoch seconds

**401** — unauthorized: the bearer credential is missing, malformed, expired, or revoked. Carries a `WWW-Authenticate: Bearer` challenge

`application/json` → ErrorBody

**404** — No hook configured, or domain not accessible

`application/json` → ErrorBody

**503** — temporary_failure: the platform's storage could not answer just now; retry after the Retry-After window. Any operation can answer this. A write that got it may have been applied, so retry it with the same idempotency key where it takes one, or read the state back first (see Transient failures in the API description)

`application/json` → ErrorBody

### Example request

```bash
curl -X GET 'https://api.open.email/api/v1/domains/{domain}/event-webhook' \
  -H 'Authorization: Bearer oek_…'
```

## TypeScript SDK

[`openemail.domains.getEventWebhook`](/docs/sdks/typescript/domains/get-event-webhook)

```ts
const eventWebhook = await openemail.domains.getEventWebhook(domain)
```
