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"
}
Notifications de formulaire
Créer une notification de formulaire
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"
}
Crée une notification programmée de rapport de formulaire.
Nécessite une clé d’API de gestion avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX) et la permission LEAD_GENERATION_EMAIL_REPORT_CAN_CREATE_UPDATE, envoyée comme valeur brute de l’en-tête Authorization — voir la présentation de l’API de gestion.string
requis
Nom interne de la notification.
string
requis
Adresse(s) e-mail du destinataire.
string
Adresse(s) e-mail en copie.
string
Adresse(s) e-mail en copie cachée.
integer
requis
L’une des valeurs
key de Lister les fréquences des notifications de formulaire.array
requis
Tableau de chaînes
form_id sur lesquelles porte cette notification. Écriture seule — la réponse reflète plutôt les formulaires résolus sous form_list.boolean
défaut:"true"
Si la notification est actuellement activée.
integer
L’id d’un espace de travail Slack connecté, pour livrer aussi via Slack.
array
Ids des canaux Slack où publier, lorsque
slack_workspace est défini.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 si le quota de rapports par e-mail du plan du compte est épuisé (partagé avec les notifications de leads) :
403
{ "detail": "You have exhausted your limit of 3 email reports.", "limit": 3 }
Voir aussi
- Lister les notifications de formulaire — voir ce qui est déjà configuré.
- Lister les fréquences des notifications de formulaire — valeurs
frequencyvalides. - Présentation de l’API de gestion — le schéma d’authentification et l’architecture de quotas dont fait partie cet endpoint.
Autorisations
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.
Réponse
201
Notification created.
Cette page vous a-t-elle été utile ?