Create a new campaign.
Response format | JSON |
---|---|
Requires authentication? | Yes |
channel_sid required | SID of the channel on which the campaign should be sent. |
---|---|
name required | Campaign name, which must be unique to the channel. |
body optional | The message body for the campaign. The body can levarage Message Templates for subscriber specific messaging. |
external_ref_id optional | Optional string to help correlate campaigns with other systems. |
tag_expression required | Escaped JSON describing a tag expression which, when evaluated, enumerates a collection of subscribers. The system will only send the message to each recipient only once, even if they're a member of multiple target groups. See the Tag Expression documentation for more information. NOTE - if you create a complex Tag Expression via the API - the UI will not understand it, and if you update from the UI, it can overwrite and change the expression. The UI assumes the left branch is the includes, and the right to be the excludes. Given that restiction, it is considered an "experts only" mode. |
media_urls optional | Optional collection of URLs pointing to media. These will be sent with the campaign message. |
send_at optional | Optional time at which campaign should be sent. If this value is not provided, the campaign will not be sent. |
send_to_inboxed optional | Optional flag indicating whether campaign messages should be sent to subscribers in the support queue ( |
curl -X POST \
-u '[SID]:[TOKEN]' \
-H 'Content-Type: application/json' \
'https://api.essential.to/v2/account/campaigns' \
-d '{"channel_sid":"sRhvpNDGZwyDeH-YRZIr9A", "name":"Test Campaign", "body": "This is the body of the test campaign", "tag_expression": "{\"tag_sids\":[\"os1hkFk7eZMe6XHAcRKOKg\"],\"left\":null,\"right\":null,\"operator\":\"UNION\"}" }'
# Sample response
{
"name": "Test Campaign",
"external_ref_id": null,
"send_at": null,
"status": "unscheduled",
"body": "This is the body of the test campaign",
"media_urls": null,
"created_at": "2017-02-21T21:00:00.145Z",
"updated_at": "2017-02-21T21:00:00.145Z",
"sid": "YIoAc9B2eV_L0gOz8uz--w",
"account_sid": "XsbrYCSo2m0sShMLOlZqtw",
"channel_sid": "sRhvpNDGZwyDeH-YRZIr9A",
"tag_expression": {
"tag_sids": null,
"left": null,
"operator": "UNION",
"right": null
},
"send_to_inboxed": true,
"results": [
]
}
Python coming soon.
Node coming soon.