curl --request POST \
--url 'https://api.scanova.io/lead/notification/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Weekly Trade Show Report",
"to": "sales@example.com",
"cc": "manager@example.com",
"frequency": 3,
"lead_ids": ["L9c2f4a1e"],
"is_active": true
}'
{
"id": 12,
"name": "Weekly Trade Show Report",
"to": "sales@example.com",
"cc": "manager@example.com",
"bcc": null,
"frequency": 3,
"frequency_display": "Once a Week",
"lead_list": [{ "lead_list_name": "Trade Show Signup", "lead_list_id": "L9c2f4a1e" }],
"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 leads
Crear una notificación de leads
POST /lead/notification/
POST
/
lead
/
notification
/
curl --request POST \
--url 'https://api.scanova.io/lead/notification/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Weekly Trade Show Report",
"to": "sales@example.com",
"cc": "manager@example.com",
"frequency": 3,
"lead_ids": ["L9c2f4a1e"],
"is_active": true
}'
{
"id": 12,
"name": "Weekly Trade Show Report",
"to": "sales@example.com",
"cc": "manager@example.com",
"bcc": null,
"frequency": 3,
"frequency_display": "Once a Week",
"lead_list": [{ "lead_list_name": "Trade Show Signup", "lead_list_id": "L9c2f4a1e" }],
"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 leads.
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 leads.array
requerido
Array de cadenas
lead_id sobre las que informa esta notificación. Solo escritura — la respuesta refleja las listas resueltas bajo lead_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/lead/notification/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Weekly Trade Show Report",
"to": "sales@example.com",
"cc": "manager@example.com",
"frequency": 3,
"lead_ids": ["L9c2f4a1e"],
"is_active": true
}'
{
"id": 12,
"name": "Weekly Trade Show Report",
"to": "sales@example.com",
"cc": "manager@example.com",
"bcc": null,
"frequency": 3,
"frequency_display": "Once a Week",
"lead_list": [{ "lead_list_name": "Trade Show Signup", "lead_list_id": "L9c2f4a1e" }],
"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 notificaciones de leads del plan de la cuenta está agotada:
403
{ "detail": "You have exhausted your limit of 3 email reports.", "limit": 3 }
Relacionado
- Listar notificaciones de leads — ver lo que ya está configurado.
- Listar frecuencias de notificaciones de leads — 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ó?