Skip to main content
PATCH
Update Campaign

Authorizations

X-Api-Key
string
header
required

Enter your API key in the format: X-Api-Key <your_key>

Body

campaign_uid
string
required
update_data
CampaignUpdateData · object
required

Response

Success

uid
string
required

Unique identifier of the campaign.

Maximum string length: 255
created_on
string<date-time>
required
read-only

Date when the campaign was created. ISO format date string in UTC timezone.

workspace_id
integer | null
required
read-only

The ID of the workspace associated with the campaign.

settings
object
required
selected_contact_lists
object[]
required
read-only
scheduled_start_datetime
string<date-time> | null

Datetime when the campaign is scheduled to start. ISO format date string in UTC timezone.

status
enum<string>

Current status of the campaign.

  • creating - Creating
  • created - Created
  • scheduled - Scheduled
  • running - Running
  • paused - Paused
  • complete - Complete
  • cancelled - Cancelled
  • failed - Failed
Available options:
creating,
created,
scheduled,
running,
paused,
complete,
cancelled,
failed
bounces
integer

Number of bounced emails in the campaign.

Required range: 0 <= x <= 2147483647
campaign_paused
boolean

Indicates whether the campaign is paused.

campaign_paused_on
string<date-time> | null

Datetime when the campaign was paused.

is_generating_schedules
boolean

Indicates if schedules are being generated for the campaign.

is_deleting_schedules
boolean

Indicates if schedules are being deleted for the campaign.

archived
boolean

Flag indicating if the campaign is archived.

is_campaign_bounce_blocked
boolean

Flag indicating if the campaign is bounce-blocked.

started_running_at
string<date-time> | null

Datetime when the campaign started running. ISO format date string in UTC timezone.

completed_at
string<date-time> | null

Datetime when the campaign was completed. ISO format date string in UTC timezone.

cancelled_at
string<date-time> | null

Datetime when the campaign was cancelled. ISO format date string in UTC timezone.