domains
POST /v1/domains/{domainId}/email-routing/addresses
Register a destination address.
Autentificare
Trimiteți o cheie API ca token de tip bearer. Cheia trebuie să aibă permisiunea domains.dns.manage; o cheie care nu o are va fi respinsă cu 403, nu 404.
Acest endpoint nu necesită un ID de organizație. Cheia ta identifică deja organizația căreia îi aparține, iar răspunsul este limitat la aceasta.
Încearcă
Înlocuiți tot ce se află între paranteze unghiulare cu propriile valori și substituentul cheie cu o cheie din tabloul de bord.
curl -X POST https://api.zinndigital.com/v1/domains/{domainId}/email-routing/addresses \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "email": <string> }'Autentificat? Consola API din panoul de control îți completează ID-ul real al organizației și propria cheie și rulează cererea în API-ul live, astfel încât să poți vedea răspunsul efectiv. Deschideți acest punct final în consola API
Detalii
**This sends mail to a third party.** The provider emails the address a verification link and will not deliver anything to it until the recipient clicks, so the response carries `verified: false` rather than pretending the destination is usable. Destination addresses are **account-scoped** at the provider, not zone-scoped: one address book serves every domain on the account. Requires `domains.dns.manage`.
Parametri
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
domainId (path) | Uuid | Da | The domain's id. |
Corp cerere
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
email | string | Da | **The provider emails this address a verification link.** It is a write that reaches a third party, so it is permissioned and audit-logged accordingly. |
Răspuns
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
address_id | string | Da | — |
email | string | Da | — |
verified | boolean | Da | A fact about the **recipient's** action, never ours: the provider emails a verification link and will not deliver until it is clicked. |
created | string | Da | — |
Erori pe care le poate returna acest punct final
401 · 403 · 404 · 422 · 429 · 503