Send Campaign
Schedule or send a campaign immediately.
MethodPOST
/api/v2/campaigns/:campaignId/sendSchedules a draft or sends it immediately. No date sends immediately. Maps to schedule_campaign. Permission: send.
Before scheduling, Lumail runs the same JEV content verification used by the editor and public API. A blocked result includes the failed checks, badges, remediation guidance, and the campaign content verification rules. Cold email and phishing are unsupported.
The campaign must be DRAFT and must contain an unsubscribe link.
Path Parameters
| Name | Type | Description |
|---|---|---|
campaignId | string | Required. Campaign id. |
Body Parameters
| Name | Type | Description |
|---|---|---|
scheduledAt | string | Optional ISO 8601 send time. Omit to send immediately. |
timezone | string | IANA timezone for the schedule. Default Europe/Paris. |
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Campaign id. |
campaignId | string | Same campaign id when the worker echoes it. |
subject | string | Subject line. |
status | string | SCHEDULED after accept. Immediate sends stay SCHEDULED until the worker starts. |
scheduledAt | string | ISO 8601 scheduled time. |
timezone | string | Schedule timezone when provided. |
recipientCount | integer | Recipients at schedule time. |
Errors
| Status | name | When |
|---|---|---|
| 401 | missing_api_key | Missing or invalid bearer token |
| 403 | missing_permission | Token lacks the send permission |
| 404 | not_found | Unknown campaign id |
| 400 | validation_error | Missing unsubscribe link, not a draft, or past scheduledAt |