INinstantly
Campaign

Add campaign variables

Changed on

Requires one of the following scopes: campaigns:update, campaigns:all, all:update, all:all

post/api/v2/campaigns/{id}/variables

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/campaigns/{id}/variables
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:01a19e6f-87e0-765a-a14b-bc833acc42c0

Campaign ID

Request body

variablesstring[] required

Example request

{
  "variables": [
    "firstName"
  ]
}

Response

A campaign that can be sent to a list of recipients

idstring uuid required

Unique identifier for the campaign

namestring required

Name of the campaign

pl_valuenumber nullable

Value of every positive lead

status-99 | -1 | -2 | 0 | 1 | 2 | 3 | 4 required

Campaign Status

is_evergreenboolean nullable

Whether the campaign is evergreen

timestamp_createdstring required

Timestamp when the campaign was created

timestamp_updatedstring required

Timestamp when the campaign was last updated

email_gapnumber nullable

The gap between emails in minutes

random_wait_maxnumber nullable

The maximum random wait time in minutes

text_onlyboolean nullable

Whether the campaign is text only

first_email_text_onlyboolean nullable

Whether the campaign is send the first email as a text only

email_liststring[]

List of accounts to use for sending emails

daily_limitnumber nullable

The daily limit for sending emails

stop_on_replyboolean nullable

Whether to stop the campaign on reply

email_tag_liststring[]

List of tags to use for sending emails

link_trackingboolean nullable

Whether to track links in emails

open_trackingboolean

Whether to track opens in emails

stop_on_auto_replyboolean nullable

Whether to stop the campaign on auto reply

daily_max_leadsinteger nullable

The daily maximum new leads to contact

prioritize_new_leadsboolean nullable

Whether to prioritize new leads

match_lead_espboolean nullable

Whether to match leads by ESP

not_sending_status1 | 2 | 3 | 4 | 99 nullable

Campaign not sending status

stop_for_companyboolean nullable

Whether to stop the campaign for the entire company(domain) when a lead replies

core_variablesobject nullable

Campaign core variables

custom_variablesobject nullable

Campaign custom variables

insert_unsubscribe_headerboolean nullable

Whether to insert an unsubscribe header in emails

allow_risky_contactsboolean nullable

Whether to allow risky contacts

disable_bounce_protectboolean nullable

Whether to disable bounce protection

cc_liststring[]

List of accounts to CC on emails

bcc_liststring[]

List of accounts to BCC on emails

organizationstring uuid nullable

Organization ID

owned_bystring uuid nullable

Owner ID

created_bystring uuid nullable

ID of the user who created the campaign

ai_sdr_idstring uuid nullable

AI Sales Agent ID that created this campaign

Example response

{
  "id": "01a19e6f-3f29-7bac-85ef-9e2b4696fd87",
  "name": "My First Campaign",
  "pl_value": 100,
  "status": 1,
  "campaign_schedule": {
    "start_date": "2025-09-25",
    "end_date": "2025-09-25",
    "schedules": [
      {
        "name": "My Schedule",
        "timing": {
          "from": "09:00",
          "to": "17:00"
        },
        "days": {
          "0": true,
          "1": true,
          "2": true,
          "3": true,
          "4": true
        },
        "timezone": "Etc/GMT+12"
      }
    ]
  },
  "sequences": [
    {
      "steps": [
        {
          "type": "email",
          "delay": 2,
          "delay_unit": "days",
          "pre_delay": 2,
          "pre_delay_unit": "days",
          "variants": [
            {
              "subject": "Hello {{firstName}}",
              "body": "Hey {{firstName}},<br/><br/>I hope you are doing well.",
              "v_disabled": true
            }
          ]
        }
      ]
    }
  ],
  "timestamp_created": "2026-11-02T22:44:13.225Z",
  "timestamp_updated": "2026-11-02T22:44:13.225Z",
  "email_gap": 10,
  "random_wait_max": 10,
  "email_list": [
    "john@doe.com"
  ],
  "daily_limit": 100,
  "email_tag_list": [
    "01a19e6f-3f29-7bac-85ef-9e2c477ab551"
  ],
  "link_tracking": true,
  "open_tracking": true,
  "daily_max_leads": 100,
  "auto_variant_select": {
    "trigger": "click_rate"
  },
  "not_sending_status": 2,
  "limit_emails_per_company_override": {
    "mode": "custom",
    "daily_limit": 3,
    "scope": "per_campaign"
  },
  "cc_list": [
    "john@doe.com"
  ],
  "bcc_list": [
    "john@doe.com"
  ],
  "organization": "01a19e6f-3f29-7bac-85ef-9e2d84e0d054",
  "owned_by": "01a19e6f-3f29-7bac-85ef-9e2eadb676ae",
  "created_by": "01a19e6f-3f29-7bac-85ef-9e2f125fb268",
  "ai_sdr_id": "01a19e6f-3f29-7bac-85ef-9e30d98def52",
  "provider_routing_rules": [
    {
      "action": "send",
      "recipient_esp": [
        "all"
      ],
      "sender_esp": [
        "all"
      ]
    }
  ]
}

Changes

  • c781051105a8Revision changes
    • breaking

      request body became required

    • breaking

      the request property became required

    • info

      added the optional property to the response with the status