Update Campaign

PATCH {{baseUrl}}/api/campaigns/:id/

Update a campaign with the given campaign ID.

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

Scopes: campaigns:write

Request Body

{"data"=>{"type"=>"campaign", "id"=>"<string>", "attributes"=>{"name"=>"<string>", "audiences"=>{"included"=>["<string>", "<string>"], "excluded"=>["<string>", "<string>"]}, "send_options"=>{"use_smart_sending"=>"<boolean>"}, "tracking_options"=>{"is_tracking_opens"=>"<boolean>", "is_tracking_clicks"=>"<boolean>", "is_add_utm"=>"<boolean>", "utm_params"=>[{"name"=>"<string>", "value"=>"<string>"}, {"name"=>"<string>", "value"=>"<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>"}}}}}

HEADERS

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

RESPONSES

status: OK

{&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;channel&quot;:&quot;\u003cstring\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;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;tracking_options&quot;:{&quot;is_tracking_opens&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_tracking_clicks&quot;:&quot;\u003cboolean\u003e&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;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;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;}}}}}