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 |