POST /v1/emails creates one address with a 30-day receiving reservation. An API-created address receives independently from the website, dashboard, or an open browser.
Let the service choose
Request a custom address
Provide local_part, domain, or both. Use a domain returned by GET /v1/domains.
Custom local parts are lowercase, at most 64 characters, and may contain letters, digits, dots, underscores, and hyphens within the documented pattern. Reserved, invalid, unavailable, or previously issued names are rejected. An address is never assigned again after expiry.
Generate one stable idempotency key for the logical creation attempt. Reuse it
after an uncertain network result; do not generate a new key for the retry.
