Launch a regular campaign
Description
Instantly starts a regular campaign if it is active. There is a one-time send.
override_source_type
and override_source_id
parameters override campaign audience for the run.
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/regulars/start
Request parameters
Parameter | Type | Example | Required | Description |
---|---|---|---|---|
token | string | "abcdefghijklmnqrstuvwxyz" | Yes | API token |
id | int | 12 | Yes | Campaign ID |
override_source_type | enum | "list" или "segment" | No | Override audience source |
override_source_id | int | 5 | No | New audience source ID |
override_limit | int | 300 | No | Override campaign limitations |
content | JSON object | {"field":"value"} | No | Additional content for API content filter node and template apicontent variables |
attach | JSON array | [] | No | Attach file(s) to campaign messages |
Request example
- JSON
- XML
{
"token": "abcdefghijklmnqrstuvwxyz",
"id": 94,
"override_source_id": 1,
"override_source_type": "list"
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<id>93</id>
<override_source_id>1</override_source_id>
<override_source_type>list</override_source_type>
</xml>
Response example
- JSON
- XML
{
"data": null,
"error": 0,
"error_text": "Successful operation"
}
<xml>
<data/>
<error>0</error>
<error_text>Successful operation</error_text>
</xml>
Response parameters
Parameter | Type | Description |
---|---|---|
error | int | Error code |
error_text | string | Error text |