---
title: "Add a webhook endpoint to an inbox address"
method: POST
path: "/inbox/webhook/endpoints"
tags: ["inbox"]
---

# Add a webhook endpoint to an inbox address

`POST /inbox/webhook/endpoints`

## Request

- Base URL: `https://api.mailly.site` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mailly.site/inbox/webhook/endpoints`
- Auth: HTTP bearer

An address can have up to 10 endpoints; every active endpoint receives its own signed delivery. While an address has an active endpoint, its mail is no longer sent to the workspace default webhook. url must be public HTTPS and unique per address. A generated signing secret is returned only once.

## Request body

- object
  - `addressId` string: Inbox address ID
  - `url` string
  - `active` boolean
  - `bodyFormat` string: text / html / markdown
  - `stripQuotes` boolean
  - `signingSecret` string

## Response `201`

Created

- object
  - `success` boolean, required
  - `endpoint` object, required
  - `signingSecret` string

## Other responses

- `400`: Invalid configuration or endpoint limit reached
- `401`: Missing or invalid API key
- `404`: Resource not found
- `409`: Duplicate url for this address
- `500`: Server error

---

[API](https://skmtc.dev/mailly/apis/mailly-api.md) · [All operations](https://skmtc.dev/mailly/apis/mailly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailly/apis/mailly-api/revisions/1ceb29637301?raw)