Create a campaign

Create a campaign that sends one template to every contact of one list. The campaign's channel is the template's channel; the list must not be a blacklist-type list, which is a suppression set rather than an audience.

The campaign starts in draft: nothing is sent until it is launched, and until then it can be renamed, scheduled, or deleted. Template and contact list are fixed at creation — only name can be changed afterwards.

Body Params

New campaign: the template to send and the contact list to send it to. The campaign's channel is the template's channel. Both are fixed at creation — only name can be changed afterwards — so a different template or list means a new campaign.

string
required
length between 3 and 120

Campaign name, 3 to 120 characters. The only field a later update can change.

uuid
required

Template rendered for every recipient. Immutable after creation.

uuid
required

Contact list whose contacts are the campaign's recipients. Immutable after creation; a blacklist-type list is a suppression set and is rejected here.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json