ساخت صندوق سازمانی

برای دامنهٔ خود صندوق (و زیرمجموعه) بسازید.

POSThttps://api.irnoti.com/v1/email/mailboxes

scope: email.manage

اگر password ندهید رمز خودکار ساخته و **فقط همین یک‌بار** در پاسخ برگردانده می‌شود (روی سرور فقط هش آن می‌ماند). parentId صندوق را زیرمجموعهٔ صندوق دیگر می‌کند. نیازمند احراز هویت تأییدشده.

پارامترها

نام	محل	نوع	توضیح
domainId *	بدنه	string	شناسهٔ دامنه.
local *	بدنه	string	بخش قبل از @.
displayName	بدنه	string	نام نمایشی.
password	بدنه	string	حداقل ۱۰ نویسه.
quotaMb	بدنه	number	حجم؛ حداکثر سقف بسته.
parentId	بدنه	string	صندوق والد.

خطاهای خاص این endpoint

402	plan_limit	سقف صندوق‌های بسته پر است.
409	address_taken	این نشانی قبلاً استفاده شده است.
401	unauthorized	کلید API نامعتبر یا منقضی است.
403	feature_disabled	قابلیت ایمیل (یا دامنهٔ دسترسی لازم) برای کلید/حساب شما فعال نیست.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

→ قبلی

بررسی رکوردهای DNS

بعدی ←

ساخت یا بروزرسانی قالب

curl -X POST 'https://api.irnoti.com/v1/email/mailboxes' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "local": "support",
  "domainId": "3",
  "displayName": "پشتیبانی"
}'

پاسخ نمونه200 OK

{
  "mailbox": {
    "id": "15",
    "kind": "hosted",
    "status": "active",
    "address": "support@example.ir"
  },
  "password": "p9Kx…"
}