mail

POST /v1/mail/services/{mailServiceId}/mailboxes

Create a mailbox.

Све mail крајње тачке

Сва документација за програмере →

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу mail.manage; кључ без ње се одбија уз 403, а не 404.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X POST https://api.zinndigital.com/v1/mail/services/{mailServiceId}/mailboxes \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "local": <string> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

Creates local@domain and returns it with its password, once. The password is never stored and cannot be read back — a lost one is replaced by resetMailboxPassword, not recovered. password is null when the backend reconciled to a mailbox that already existed and refused to rotate a live password; show that as "we could not display a password", never as a blank one. Requires mail.manage. Fails 409 on a duplicate address, and 422 when the service is not live yet or the domain is at its mailbox ceiling.

Параметри

НазивТипОбавезноШта је ово
mailServiceId (path)UuidДаEmail service ID (UUIDv7).

Тело захтева

НазивТипОбавезноШта је ово
localstringДаThe part before the @.
sendbooleanНе—
receivebooleanНе—

Одговор

НазивТипОбавезноШта је ово
mailboxMailboxДаOne mailbox. Never carries a password — see MailboxCreated.
passwordobjectДаThe password, shown once. null when the backend reconciled to a mailbox that already existed and refused to rotate a live password.

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 409 · 422 · 429 · 503