# Read the mailbox's event webhook

The mailbox-scope event webhook: endpoint URL and delivery status. The signing secret is write-only and never returned.

## `GET /api/v1/mailboxes/{mailboxId}/event-webhook`

### Path parameters

- `mailboxId` (string, required) — Mailbox ULID identifier

### 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 mailbox 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/mailboxes/{mailboxId}/event-webhook' \
  -H 'Authorization: Bearer oek_…'
```

## TypeScript SDK

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

```ts
const eventWebhook = await openemail.mailboxes.getEventWebhook(mailboxId)
```
