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"
}
Notificaciones de formulario
Crear una notificación de formulario
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"
}
Crea una notificación programada de informe de formulario.
Requiere una clave de API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX) y el permiso LEAD_GENERATION_EMAIL_REPORT_CAN_CREATE_UPDATE, enviada como el valor sin procesar del encabezado Authorization — consulte el resumen de la API de gestión.string
requerido
Nombre interno de la notificación.
string
requerido
Dirección(es) de correo del destinatario.
string
Dirección(es) de correo en CC.
string
Dirección(es) de correo en CCO.
integer
requerido
Uno de los valores
key de Listar frecuencias de notificaciones de formulario.array
requerido
Array de cadenas
form_id sobre las que informa esta notificación. Solo escritura — la respuesta refleja los formularios resueltos bajo form_list en su lugar.boolean
predeterminado:"true"
Si la notificación está actualmente habilitada.
integer
El id de un espacio de trabajo de Slack conectado, para entregar también por Slack.
array
Ids de canales de Slack a los que publicar, cuando
slack_workspace está establecido.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 la cuota de informes por correo del plan de la cuenta está agotada (compartida con notificaciones de leads):
403
{ "detail": "You have exhausted your limit of 3 email reports.", "limit": 3 }
Relacionado
- Listar notificaciones de formulario — ver lo que ya está configurado.
- Listar frecuencias de notificaciones de formulario — valores válidos de
frequency. - Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas a la que pertenece este endpoint.
Autorizaciones
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.
Respuesta
201
Notification created.
¿Esta página le ayudó?