---
title: "Check whether a recipient address is assigned"
method: POST
path: "/inbound-email/validate"
tags: ["public"]
---

# Check whether a recipient address is assigned

`POST /inbound-email/validate`

## 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/inbound-email/validate`
- Auth: none required

Called at the RCPT TO stage; authenticated with the `x-mailly-inbound-secret` header.

## Request body

- object
  - `address` string: Recipient address to check

## Response `200`

Check result

- object
  - `success` boolean, required
  - `accepted` boolean, required: Whether a matching inbox exists

## Other responses

- `400`: Invalid request
- `401`: Inbound secret mismatch
- `503`: Ingestion is not configured

---

[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)