Update campaign (draft status only)

patch

https://api.omnisend.com/api/campaigns/{id}

Update a campaign draft. Only campaigns in 'draft' status can be updated; any other status returns 409.
To change a campaign that is no longer a draft, copy it and edit the new draft copy.

Scopes:
campaigns.write

Rate Limiting:
This endpoint is rate limited to 400 requests per minute.

Path Params

string

required

Campaign ID (24 character hexadecimal)

Body Params

Campaign update data

Campaign update request

abTest

object

A/B test settings. Only applicable to A/B campaigns (campaigns with type "abTest").
Full replacement — all provided variant and setting fields replace existing values.
templateID / contentID are excluded: templates are set at create time and cannot
be changed via PATCH.

audience

object

Campaign audience. Included and excluded segments must not overlap

boosterSettings

object

Booster-specific settings. Only applicable to booster campaigns (campaigns with type "booster").

content

object

Campaign content. Only specified fields will be updated

language

string

Campaign language locale in xx_XX format. Must be a supported language

name

string

length ≤ 250

Campaign name

sendingSettings

object

Campaign sending settings.
Full object replacement - all fields must be provided when updating

Headers

Omnisend-Version

string

required

Defaults to 2026-03-15

API version that specifies the response format and behaviour

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Updated campaign

400Request contains invalid or missing fields

401Authentication is missing or invalid

403Insufficient permissions for this operation

404Campaign not found

409Campaign state does not allow modification

410API version has been retired

429Rate limit exceeded

500Unexpected error occurred