Skip to main content
POST
email.domain.add

Authorizations

Authorization
string
header
required

A Lath API key: lath_live_… or lath_test_… on a server, lath_live_pk… or lath_test_pk… in a browser.

Headers

Idempotency-Key
string

Replays the stored response for the same key and input; refuses different input.

Body

application/json
domain
string
required

Bare domain, like mail.example.com

Required string length: 3 - 253
returnPath
string

The subdomain bounces return to (the MAIL FROM), as one label: "send" makes it send.. Defaults to "lath".

Required string length: 1 - 63

Response

{ activityId, result }. activityId is empty for reads.

activityId
string
required

The activity this call created, or empty for a read.

result
object
required
Last modified on September 23, 2026