domains
POST /v1/domains/{domainId}/email-routing/addresses
Register a destination address.
Autentikasi
Kirim kunci API sebagai token bearer. Kunci tersebut harus memiliki izin domains.dns.manage; kunci tanpa izin tersebut akan ditolak dengan status 403, bukan 404.
Endpoint ini tidak memerlukan id organisasi. Kunci Anda telah mengidentifikasi organisasi tempatnya berafiliasi, dan respons akan dibatasi untuk organisasi tersebut.
Coba
Ganti apa pun di dalam tanda kurung sudut dengan nilai Anda sendiri, dan placeholder kunci dengan kunci dari dasbor Anda.
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> }'Sudah masuk? Konsol API di dasbor Anda akan mengisi ID organisasi asli dan kunci Anda sendiri, serta menjalankan permintaan terhadap API langsung sehingga Anda dapat melihat respons aktualnya. Buka titik akhir ini di konsol API
Detail
**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`.
Parameter
| Nama | Jenis | Wajib | Tentang apa ini |
|---|---|---|---|
domainId (path) | Uuid | Ya | The domain's id. |
Isi permintaan
| Nama | Jenis | Wajib | Tentang apa ini |
|---|---|---|---|
email | string | Ya | **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. |
Tanggapan
| Nama | Jenis | Wajib | Tentang apa ini |
|---|---|---|---|
address_id | string | Ya | — |
email | string | Ya | — |
verified | boolean | Ya | 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 | Ya | — |
Kesalahan yang dapat dikembalikan oleh titik akhir ini
401 · 403 · 404 · 422 · 429 · 503