post https://api.mailerlite.com/api/v2/campaigns//actions/
Send, schedule or cancel campaign [Rate limited]
Every action is active due to some conditions (campaign type) described in table below.
Action | Campaign type | Campaign Status | Description |
---|---|---|---|
send | regular ab followup | draft | You can send every campaign in draft which has step value equal to 3 |
cancel | regular ab followup rss | outbox | You can cancel every campaign in outbox . |
Please take attention that every action is available only for specific type campaigns:
send
: you can send or schedule those campaigns which are indraft
and hasstep
value equal to3
cancel
: you can cancel only those campaigns which are inoutbox
Send or schedule campaign
Send or schedule endpoint has additional body parameters associated with Google analytics, schedule and followup campaigns.
Campaign sending time
We provide two options how campaign can be sent regarding to sending time.
Send now
There is no need to use request parameters for all types of campaigns.
Send later (schedule)
For all types of campaigns:
type = 2
date
is requiredtimezone_id
is optional. Default value is ID of timezone which is associated with Account
Followup campaign schedule
If campaign type is
followup
, its followup mail will be sent 24 hours from campaign sending time by default. If you want to set custom time for followup campaign, then use these additional request parameters:
followup_schedule = specific
followup_date
is requiredfollowup_timezone_id
is optional. Default value is ID of timezone which is associated with Account
Request Body Parameters
Parameter | Type | Description |
---|---|---|
type | Integer | Possible values: - 1 - send instantly (default value)- 2 - schedule send |
followup_schedule | String | Possible values: - 24h - followup mail is sent in 24 hours (default value)- specific - must provide custom time described belowOnly for followup campaigns |
analytics | Integer | Possible values: - 0 - false- 1 - true |
date | String | Format:yyyy-mm-dd H:i Available when type is 2 |
timezone_id | Integer | ID of Timezone Available when type is 2 |
followup_date | String | Format:yyyy-mm-dd H:i Available only for followup campaigns when followup_schedule is specific |
followup_timezone_id | Integer | ID of Timezone Available only for followup campaigns when followup_schedule is specific |