افزودن مخاطب

مخاطب جدید می‌سازد.

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

scope: email.manage

نشانی تکراری خطا می‌دهد.

پارامترها

نام	محل	نوع	توضیح
email *	بدنه	string	نشانی ایمیل.
name	بدنه	string	نام.
company	بدنه	string	شرکت.
phone	بدنه	string	تلفن.
note	بدنه	string	یادداشت (حداکثر ۵۰۰ نویسه).
groups	بدنه	string[]	گروه‌ها (حداکثر ۱۰).
isBlocked	بدنه	boolean	مسدود؛ نامهٔ این فرستنده به هرزنامه می‌رود.

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

401	unauthorized	کلید API نامعتبر یا منقضی است.
403	insufficient_scope	کلید API دامنهٔ دسترسی لازم را ندارد.
400	validation_error	ورودی نامعتبر است؛ خطای هر فیلد در `details` آمده است.

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

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

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

curl -X POST 'https://api.irnoti.com/v1/email/contacts' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "علی رضایی",
  "email": "ali@example.com",
  "groups": [
    "مشتری"
  ]
}'

پاسخ نمونه200 OK

{
  "id": "31",
  "name": "علی رضایی",
  "note": null,
  "email": "ali@example.com",
  "phone": "09120000000",
  "groups": [
    "مشتری"
  ],
  "company": "نمونه",
  "isBlocked": false
}