Skip to main content

Activate campaign

Description

Activates a campaign.

Can be used to activate and launch a campaign instantly.
Also you can override campaign audience source for a different database or segment.

If run_now = true, the specified campaign launches instantly.

override_source_type and override_source_id are valid only if run_now = true.

override_limit parameter sets sending limitations for the current run.

If no override options are set - campaigns will use their default audience sources and sending limitations.

Request URL

Method: POST

https://example.com/api/v1.1/campaigns/activate/

Request parameters

ParameterTypeExampleRequiredDescription
tokenstring"abcdefghijklmnqrstuvwxyz"YesAPI token
idint12YesCampaign ID
run_nowbooltrueNoLaunch campaign instantly
override_source_typeenum"list" or "segment"NoOverride audience source
override_source_idint5NoNew audience source ID
override_limitint300NoOverride campaign limitations
contentJSON object{"field":"value"}NoAdditional content for API content filter node and template apicontent variables
attachJSON array[]NoAttach file(s) to campaign messages

Request example

{
"id": 4727,
"override_source_id": 2550,
"override_source_type": "segment",
"run_now": true,
"token": "abcdefghijklmnqrstuvwxyz"
}

Response example

{
"data": null,
"error": 0,
"error_text": "Successful operation"
}

Response parameters

ParameterTypeDescription
errorintError code
error_textstringError text