Create Campaign

POST {{baseUrl}}/api/campaigns/

Creates a campaign given a set of parameters, then returns it.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes: campaigns:write

Request Body

{"data"=>{"type"=>"campaign", "attributes"=>{"name"=>"<string>", "audiences"=>{"included"=>["<string>", "<string>"], "excluded"=>["<string>", "<string>"]}, "send_strategy"=>{"method"=>"<string>", "options_static"=>{"datetime"=>"<dateTime>", "is_local"=>"<boolean>", "send_past_recipients_immediately"=>"<boolean>"}, "options_throttled"=>{"datetime"=>"<dateTime>", "throttle_percentage"=>"<integer>"}, "options_sto"=>{"date"=>"<date>"}}, "campaign-messages"=>{"data"=>[{"type"=>"campaign-message", "attributes"=>{"channel"=>"<string>", "label"=>"<string>", "content"=>{"subject"=>"<string>", "preview_text"=>"<string>", "from_email"=>"<string>", "from_label"=>"<string>", "reply_to_email"=>"<string>", "cc_email"=>"<string>", "bcc_email"=>"<string>"}, "render_options"=>{"shorten_links"=>true, "add_org_prefix"=>true, "add_info_link"=>true, "add_opt_out_language"=>"<boolean>"}}}, {"type"=>"campaign-message", "attributes"=>{"channel"=>"<string>", "label"=>"<string>", "content"=>{"subject"=>"<string>", "preview_text"=>"<string>", "from_email"=>"<string>", "from_label"=>"<string>", "reply_to_email"=>"<string>", "cc_email"=>"<string>", "bcc_email"=>"<string>"}, "render_options"=>{"shorten_links"=>true, "add_org_prefix"=>true, "add_info_link"=>true, "add_opt_out_language"=>"<boolean>"}}}]}, "send_options"=>{"use_smart_sending"=>"<boolean>"}, "tracking_options"=>{"is_add_utm"=>"<boolean>", "utm_params"=>[{"name"=>"<string>", "value"=>"<string>"}, {"name"=>"<string>", "value"=>"<string>"}], "is_tracking_clicks"=>"<boolean>", "is_tracking_opens"=>"<boolean>"}}}}

HEADERS

KeyDatatypeRequiredDescription
revisionstring(Required) API endpoint revision (format: YYYY-MM-DD[.suffix])
Content-Typestring
Acceptstring

RESPONSES

status: Created

{&quot;data&quot;:{&quot;type&quot;:&quot;campaign&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;attributes&quot;:{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;archived&quot;:&quot;\u003cboolean\u003e&quot;,&quot;audiences&quot;:{&quot;included&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;excluded&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},&quot;send_options&quot;:{&quot;use_smart_sending&quot;:&quot;\u003cboolean\u003e&quot;},&quot;tracking_options&quot;:{&quot;is_add_utm&quot;:&quot;\u003cboolean\u003e&quot;,&quot;utm_params&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;}],&quot;is_tracking_clicks&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_tracking_opens&quot;:&quot;\u003cboolean\u003e&quot;},&quot;send_strategy&quot;:{&quot;method&quot;:&quot;\u003cstring\u003e&quot;,&quot;options_static&quot;:{&quot;datetime&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;is_local&quot;:&quot;\u003cboolean\u003e&quot;,&quot;send_past_recipients_immediately&quot;:&quot;\u003cboolean\u003e&quot;},&quot;options_throttled&quot;:{&quot;datetime&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;throttle_percentage&quot;:&quot;\u003cinteger\u003e&quot;},&quot;options_sto&quot;:{&quot;date&quot;:&quot;\u003cdate\u003e&quot;}},&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;scheduled_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;send_time&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;},&quot;relationships&quot;:{&quot;campaign-messages&quot;:{&quot;data&quot;:[{&quot;type&quot;:&quot;campaign-message&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;},{&quot;type&quot;:&quot;campaign-message&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}],&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;related&quot;:&quot;\u003curi\u003e&quot;}},&quot;tags&quot;:{&quot;data&quot;:[{&quot;type&quot;:&quot;tag&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;},{&quot;type&quot;:&quot;tag&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;}],&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;related&quot;:&quot;\u003curi\u003e&quot;}}}}}