This schema describes objects returned by the Campaign endpoints.
Fields
| Field | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | Yes | Unique identifier for the campaign (read-only) |
name | string | Yes | Name of the campaign |
pl_value | number, nullable | No | Value of every positive lead |
status | number | Yes | Campaign Status. Possible values: -99 (Account Suspended), -1 (Accounts Unhealthy), -2 (Bounce Protect), 0 (Draft), 1 (Active), 2 (Paused), 3 (Completed), 4 (Running Subsequences) (read-only) |
is_evergreen | boolean, nullable | No | Whether the campaign is evergreen |
campaign_schedule | object | Yes | Campaign schedule |
campaign_schedule.start_date | string (date), nullable | No | Start date in YYYY-MM-DD format. Uses the campaign’s timezone. |
campaign_schedule.end_date | string (date), nullable | No | End date in YYYY-MM-DD format. Uses the campaign’s timezone. |
campaign_schedule.schedules | array | No | |
campaign_schedule.schedules[].name | string | No | |
campaign_schedule.schedules[].timing | object | No | |
campaign_schedule.schedules[].timing.from | string | No | |
campaign_schedule.schedules[].timing.to | string | No | |
campaign_schedule.schedules[].days | object | No | |
campaign_schedule.schedules[].days.0 | boolean | No | |
campaign_schedule.schedules[].days.1 | boolean | No | |
campaign_schedule.schedules[].days.2 | boolean | No | |
campaign_schedule.schedules[].days.3 | boolean | No | |
campaign_schedule.schedules[].days.4 | boolean | No | |
campaign_schedule.schedules[].days.5 | boolean | No | |
campaign_schedule.schedules[].days.6 | boolean | No | |
campaign_schedule.schedules[].timezone | string | No | Possible values: Etc/GMT+12, Etc/GMT+11, Etc/GMT+10, America/Anchorage, America/Dawson, America/Creston, America/Chihuahua, America/Boise, America/Belize, America/Chicago, America/Bahia_Banderas, America/Regina, America/Bogota, America/Detroit, America/Indiana/Marengo, America/Caracas, America/Asuncion, America/Glace_Bay, America/Campo_Grande, America/Anguilla, America/Santiago, America/St_Johns, America/Sao_Paulo, America/Argentina/La_Rioja, America/Araguaina, America/Godthab, America/Montevideo, America/Bahia, America/Noronha, America/Scoresbysund, Atlantic/Cape_Verde, Africa/Casablanca, America/Danmarkshavn, Europe/Isle_of_Man, Atlantic/Canary, Africa/Abidjan, Arctic/Longyearbyen, Europe/Belgrade, Africa/Ceuta, Europe/Sarajevo, Africa/Algiers, Africa/Windhoek, Asia/Nicosia, Asia/Beirut, Africa/Cairo, Asia/Damascus, Europe/Bucharest, Africa/Blantyre, Europe/Helsinki, Europe/Istanbul, Asia/Jerusalem, Africa/Tripoli, Asia/Amman, Asia/Baghdad, Europe/Kaliningrad, Asia/Aden, Africa/Addis_Ababa, Europe/Kirov, Europe/Astrakhan, Asia/Tehran, Asia/Dubai, Asia/Baku, Indian/Mahe, Asia/Tbilisi, Asia/Yerevan, Asia/Kabul, Antarctica/Mawson, Asia/Yekaterinburg, Asia/Karachi, Asia/Kolkata, Asia/Colombo, Asia/Kathmandu, Antarctica/Vostok, Asia/Dhaka, Asia/Rangoon, Antarctica/Davis, Asia/Novokuznetsk, Asia/Hong_Kong, Asia/Krasnoyarsk, Asia/Brunei, Australia/Perth, Asia/Taipei, Asia/Choibalsan, Asia/Irkutsk, Asia/Dili, Asia/Pyongyang, Australia/Adelaide, Australia/Darwin, Australia/Brisbane, Australia/Melbourne, Antarctica/DumontDUrville, Australia/Currie, Asia/Chita, Antarctica/Macquarie, Asia/Sakhalin, Pacific/Auckland, Etc/GMT-12, Pacific/Fiji, Asia/Anadyr, Asia/Kamchatka, Etc/GMT-13, Pacific/Apia |
sequences | array | No | List of sequences (the actual email copy). Even though this field is an array, only the first element is used, so please provide only one array item, and add the steps to that array |
sequences[].steps | array | No | |
sequences[].steps[].type | string | No | Type of step. This has to be ‘email’ always - it’s the only supported type for now. Possible values: email (This steps represents an email) |
sequences[].steps[].delay | number | No | The delay value before sending the NEXT email. The unit is determined by the delay_unit field (defaults to days). |
sequences[].steps[].delay_unit | string | No | The unit of time for the delay value (minutes, hours, or days). Defaults to days for backward compatibility.. Possible values: minutes, hours, days |
sequences[].steps[].pre_delay | number | No | The delay value before sending the FIRST email in a subsequence. Only applicable to subsequences - this field is ignored for regular campaigns. The unit is determined by the pre_delay_unit field (defaults to days). |
sequences[].steps[].pre_delay_unit | string | No | The unit of time for the pre_delay value (minutes, hours, or days). Only applicable to subsequences - this field is ignored for regular campaigns. Defaults to days for backward compatibility.. Possible values: minutes, hours, days |
sequences[].steps[].variants | array | No | |
sequences[].steps[].variants[].subject | string | No | |
sequences[].steps[].variants[].body | string | No | |
sequences[].steps[].variants[].v_disabled | boolean | No | Whether this variant is disabled. By default, all the variants are enabled. Please set this to true if you want to disable this variant |
timestamp_created | string | Yes | Timestamp when the campaign was created (read-only) |
timestamp_updated | string | Yes | Timestamp when the campaign was last updated (read-only) |
email_gap | number, nullable | No | The gap between emails in minutes |
random_wait_max | number, nullable | No | The maximum random wait time in minutes |
text_only | boolean, nullable | No | Whether the campaign is text only |
first_email_text_only | boolean, nullable | No | Whether the campaign is send the first email as a text only |
email_list | array | No | List of accounts to use for sending emails |
daily_limit | number, nullable | No | The daily limit for sending emails |
stop_on_reply | boolean, nullable | No | Whether to stop the campaign on reply |
email_tag_list | array | No | List of tags to use for sending emails |
link_tracking | boolean, nullable | No | Whether to track links in emails |
open_tracking | boolean, nullable | No | Whether to track opens in emails |
stop_on_auto_reply | boolean, nullable | No | Whether to stop the campaign on auto reply |
daily_max_leads | number, nullable | No | The daily maximum new leads to contact |
prioritize_new_leads | boolean, nullable | No | Whether to prioritize new leads |
auto_variant_select | object, nullable | No | Auto variant select settings |
auto_variant_select.trigger | string | No | Possible values: reply_rate, click_rate, open_rate |
match_lead_esp | boolean, nullable | No | Whether to match leads by ESP |
not_sending_status | number, nullable | No | Campaign not sending status. Possible values: 1 (Campaign is currently not within its sending schedule.), 2 (Campaign is currently waiting for a lead to process.), 3 (Campaign has reached its daily sending limit.), 4 (All sending accounts for this campaign have reached their daily sending limit.), 99 (Campaign is currently not sending due to an error. Please contact support for assistance.) (read-only) |
stop_for_company | boolean, nullable | No | Whether to stop the campaign for the entire company(domain) when a lead replies |
core_variables | object, nullable | No | Campaign core variables (read-only) |
custom_variables | object, nullable | No | Campaign custom variables (read-only) |
insert_unsubscribe_header | boolean, nullable | No | Whether to insert an unsubscribe header in emails |
allow_risky_contacts | boolean, nullable | No | Whether to allow risky contacts |
disable_bounce_protect | boolean, nullable | No | Whether to disable bounce protection |
limit_emails_per_company_override | object, nullable | No | Overrides the workspace-wide limit emails per company setting for this campaign. |
limit_emails_per_company_override.mode | string | No | Possible values: custom, disabled |
limit_emails_per_company_override.daily_limit | number | No | |
limit_emails_per_company_override.scope | string | No | Possible values: per_campaign, across_workspace |
cc_list | array | No | List of accounts to CC on emails |
bcc_list | array | No | List of accounts to BCC on emails |
organization | string (uuid), nullable | No | Organization ID (read-only) |
owned_by | string (uuid), nullable | No | Owner ID |
ai_sdr_id | string (uuid), nullable | No | AI SDR ID that created this campaign |
provider_routing_rules | array | No | Auto variant select settings |
provider_routing_rules[].action | string | No | Possible values: send, do_not_send |
provider_routing_rules[].recipient_esp | array | No | |
provider_routing_rules[].sender_esp | array | No |