Sign in

v7

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-121372601.5 MB
Campaigns

Update Campaign

Update an existing campaign.

Campaigns can only be updated if they are in the draft or changes_required status. Updating a campaign will trigger reprocessing and set its status back to drafting.

post/print-mail/v1/campaigns/{id}

Path parameters

idstring required

The unique identifier (campaign_...) for the campaign to update.

Request body

descriptionstring nullable

An optional description for the campaign. Set to null to remove the existing description.

metadataobject nullable

Optional key-value data associated with the campaign. Set to null to remove existing metadata.

mailingListstring

The ID of the mailing list to associate with this campaign.

defaultSenderContactstring nullable

The ID of the default sender contact. Set to null to remove.

Response

The updated campaign details, now in drafting status.

idstring required

A unique ID prefixed with campaign_

descriptionstring

An optional string describing this resource. Will be visible in the API and the dashboard.

metadataobject

See the section on Metadata.

liveboolean required

true if this is a live mode resource else false.

createdAtstring date-time required

The UTC time at which this resource was created.

updatedAtstring date-time required

The UTC time at which this resource was last updated.

status'drafting' | 'changes_required' | 'creating_orders' | 'draft' | 'ready' | 'printing' | 'processed_for_delivery' required

Status of the campaign lifecycle.

defaultSenderContactstring

The ID of the default sender contact to use for orders if not specified per recipient.

mailingListstring required

The ID of the mailing list associated with this campaign.

createdCountinteger required

The number of orders successfully created for this campaign.

orderPreviewURLstring uri

A temporary URL to preview the first rendered order, available once the campaign status is 'draft' or later.

sendDatestring date-time

The scheduled date and time for the campaign to be sent.

reportURLstring uri

A temporary URL to download the processing report, available once the campaign is in the ready status.