---
title: "Get mailbox webhook config"
method: GET
path: "/api/emails/{address}/webhook"
tags: ["Email"]
---

# Get mailbox webhook config

`GET /api/emails/{address}/webhook`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/emails/{address}/webhook`
- Auth: HTTP bearer

Returns the webhook URL, signing secret, configured auth header names, and status for a mailbox. Header values are never returned.

## Path parameters

- `address` string, required

## Response `200`

Webhook config

- object
  - `address` string
  - `webhook_url` string, nullable
  - `signing_secret` string, nullable
  - `has_webhook` boolean
  - `events` string[]: Events this webhook carries: email.received, any delivery verdict on outbound mail (email.delivered, email.bounced, email.failed, email.suppressed, email.complained, email.delayed) and the agent hand-over notices (assistant.item.delegated, assistant.item.recalled); empty without a webhook
  - `header_names` string[]: Configured auth header names; values are never returned
  - `hint` string

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)