curl --request POST \
--url 'https://api.scanova.io/forms/notification/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Weekly Booth Signups",
"to": "sales@example.com",
"cc": "manager@example.com",
"frequency": 3,
"form_ids": ["F8a9b0c1d2e3f4g5h"],
"is_active": true
}'
{
"id": 21,
"name": "Weekly Booth Signups",
"to": "sales@example.com",
"cc": "manager@example.com",
"bcc": null,
"frequency": 3,
"frequency_display": "Once a Week",
"form_list": [{ "form_name": "Booth Signup", "form_id": "F8a9b0c1d2e3f4g5h" }],
"is_active": true,
"slack_workspace": null,
"slack_channel_ids": null,
"created_by": { "id": 41, "email": "you@example.com" },
"created": "2026-09-08T10:05:00+05:30",
"modified": "2026-09-08T10:05:00+05:30"
}
إشعارات النموذج
إنشاء إشعار نموذج
POST /forms/notification/
POST
/
forms
/
notification
/
curl --request POST \
--url 'https://api.scanova.io/forms/notification/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Weekly Booth Signups",
"to": "sales@example.com",
"cc": "manager@example.com",
"frequency": 3,
"form_ids": ["F8a9b0c1d2e3f4g5h"],
"is_active": true
}'
{
"id": 21,
"name": "Weekly Booth Signups",
"to": "sales@example.com",
"cc": "manager@example.com",
"bcc": null,
"frequency": 3,
"frequency_display": "Once a Week",
"form_list": [{ "form_name": "Booth Signup", "form_id": "F8a9b0c1d2e3f4g5h" }],
"is_active": true,
"slack_workspace": null,
"slack_channel_ids": null,
"created_by": { "id": 41, "email": "you@example.com" },
"created": "2026-09-08T10:05:00+05:30",
"modified": "2026-09-08T10:05:00+05:30"
}
ينشئ إشعار تقرير نموذج مجدولًا.
يُعاد
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_EMAIL_REPORT_CAN_CREATE_UPDATE، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.string
مطلوب
الاسم الداخلي للإشعار.
string
مطلوب
عنوان (عناوين) البريد الإلكتروني للمستلم.
string
عنوان (عناوين) البريد الإلكتروني في نسخة كربونية.
string
عنوان (عناوين) البريد الإلكتروني في نسخة كربونية مخفية.
integer
مطلوب
إحدى قيم
key من سرد ترددات إشعارات النموذج.array
مطلوب
مصفوفة من سلاسل
form_id التي يقدّم هذا الإشعار تقارير عنها. للكتابة فقط — تعكس الاستجابة بدلاً من ذلك النماذج المحلولة تحت form_list.boolean
افتراضي:"true"
ما إذا كان الإشعار مفعّلًا حاليًا.
integer
معرّف مساحة عمل Slack متصلة، للتسليم أيضًا عبر Slack.
array
معرّفات قنوات Slack التي يُنشَر إليها، عند تعيين
slack_workspace.curl --request POST \
--url 'https://api.scanova.io/forms/notification/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Weekly Booth Signups",
"to": "sales@example.com",
"cc": "manager@example.com",
"frequency": 3,
"form_ids": ["F8a9b0c1d2e3f4g5h"],
"is_active": true
}'
{
"id": 21,
"name": "Weekly Booth Signups",
"to": "sales@example.com",
"cc": "manager@example.com",
"bcc": null,
"frequency": 3,
"frequency_display": "Once a Week",
"form_list": [{ "form_name": "Booth Signup", "form_id": "F8a9b0c1d2e3f4g5h" }],
"is_active": true,
"slack_workspace": null,
"slack_channel_ids": null,
"created_by": { "id": 41, "email": "you@example.com" },
"created": "2026-09-08T10:05:00+05:30",
"modified": "2026-09-08T10:05:00+05:30"
}
403 إذا استُنفدت حصة تقارير البريد الإلكتروني الخاصة بخطة الحساب (مشتركة مع إشعارات العملاء المحتملين):
403
{ "detail": "You have exhausted your limit of 3 email reports.", "limit": 3 }
ذو صلة
- سرد إشعارات النموذج — رؤية ما هو مُهيَّأ بالفعل.
- سرد ترددات إشعارات النموذج — قيم
frequencyالصالحة. - نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
الاستجابة
201
Notification created.
هل كانت هذه الصفحة مفيدة؟