List campaign

List campaign

curl --request GET \
  --url https://api.instantly.ai/api/v2/campaigns \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.instantly.ai/api/v2/campaigns"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.instantly.ai/api/v2/campaigns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.get("https://api.instantly.ai/api/v2/campaigns")
  .header("Authorization", "Bearer <token>")
  .asString();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.instantly.ai/api/v2/campaigns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.instantly.ai/api/v2/campaigns"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "items": [
    {
      "id": "019f985c-62ff-7158-967d-71a8669cdecc",
      "name": "My First Campaign",
      "status": 1,
      "campaign_schedule": {
        "schedules": [
          {
            "name": "My Schedule",
            "timing": {
              "from": "09:00",
              "to": "17:00"
            },
            "days": {
              "0": true,
              "1": true,
              "2": true,
              "3": true,
              "4": true,
              "5": false,
              "6": false
            },
            "timezone": "Etc/GMT+12"
          }
        ],
        "start_date": "2025-09-25",
        "end_date": "2025-09-25"
      },
      "timestamp_created": "2026-07-25T08:20:19.327Z",
      "timestamp_updated": "2026-07-25T08:20:19.327Z",
      "pl_value": 100,
      "is_evergreen": false,
      "sequences": [
        {
          "steps": [
            {
              "type": "email",
              "delay": 2,
              "variants": [
                {
                  "subject": "Hello {{firstName}}",
                  "body": "Hey {{firstName}},\n\nI hope you are doing well.",
                  "v_disabled": true
                }
              ],
              "delay_unit": "days",
              "pre_delay": 2,
              "pre_delay_unit": "days"
            }
          ]
        }
      ],
      "email_gap": 10,
      "random_wait_max": 10,
      "text_only": false,
      "first_email_text_only": false,
      "email_list": [
        "john@doe.com"
      ],
      "daily_limit": 100,
      "stop_on_reply": false,
      "email_tag_list": [
        "019f985c-62ff-7158-967d-71a95cfbb8ec"
      ],
      "link_tracking": true,
      "open_tracking": true,
      "stop_on_auto_reply": false,
      "daily_max_leads": 100,
      "prioritize_new_leads": false,
      "auto_variant_select": {},
      "match_lead_esp": false,
      "not_sending_status": 2,
      "stop_for_company": false,
      "core_variables": {},
      "custom_variables": {},
      "insert_unsubscribe_header": false,
      "allow_risky_contacts": false,
      "disable_bounce_protect": false,
      "limit_emails_per_company_override": {
        "daily_limit": 2
      },
      "cc_list": [
        "john@doe.com"
      ],
      "bcc_list": [
        "john@doe.com"
      ],
      "organization": "019f985c-62ff-7158-967d-71aaf0f64e82",
      "owned_by": "019f985c-6300-7bee-acb9-9a68dfa217ef",
      "ai_sdr_id": "019f985c-6300-7bee-acb9-9a69e7c17a0b",
      "provider_routing_rules": [
        {
          "action": "send",
          "recipient_esp": [
            "all"
          ],
          "sender_esp": [
            "all"
          ]
        }
      ]
    }
  ],
  "next_starting_after": "019f985c-92b0-777b-959b-90ca3d64319f"
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing Authorization header"
}

{
  "statusCode": 402,
  "error": "Payment Required",
  "message": "Workspace does not have an active paid plan"
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded"
}

GET

api

campaigns

List campaign

curl --request GET \
  --url https://api.instantly.ai/api/v2/campaigns \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.instantly.ai/api/v2/campaigns"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.instantly.ai/api/v2/campaigns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.get("https://api.instantly.ai/api/v2/campaigns")
  .header("Authorization", "Bearer <token>")
  .asString();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.instantly.ai/api/v2/campaigns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.instantly.ai/api/v2/campaigns"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "items": [
    {
      "id": "019f985c-62ff-7158-967d-71a8669cdecc",
      "name": "My First Campaign",
      "status": 1,
      "campaign_schedule": {
        "schedules": [
          {
            "name": "My Schedule",
            "timing": {
              "from": "09:00",
              "to": "17:00"
            },
            "days": {
              "0": true,
              "1": true,
              "2": true,
              "3": true,
              "4": true,
              "5": false,
              "6": false
            },
            "timezone": "Etc/GMT+12"
          }
        ],
        "start_date": "2025-09-25",
        "end_date": "2025-09-25"
      },
      "timestamp_created": "2026-07-25T08:20:19.327Z",
      "timestamp_updated": "2026-07-25T08:20:19.327Z",
      "pl_value": 100,
      "is_evergreen": false,
      "sequences": [
        {
          "steps": [
            {
              "type": "email",
              "delay": 2,
              "variants": [
                {
                  "subject": "Hello {{firstName}}",
                  "body": "Hey {{firstName}},\n\nI hope you are doing well.",
                  "v_disabled": true
                }
              ],
              "delay_unit": "days",
              "pre_delay": 2,
              "pre_delay_unit": "days"
            }
          ]
        }
      ],
      "email_gap": 10,
      "random_wait_max": 10,
      "text_only": false,
      "first_email_text_only": false,
      "email_list": [
        "john@doe.com"
      ],
      "daily_limit": 100,
      "stop_on_reply": false,
      "email_tag_list": [
        "019f985c-62ff-7158-967d-71a95cfbb8ec"
      ],
      "link_tracking": true,
      "open_tracking": true,
      "stop_on_auto_reply": false,
      "daily_max_leads": 100,
      "prioritize_new_leads": false,
      "auto_variant_select": {},
      "match_lead_esp": false,
      "not_sending_status": 2,
      "stop_for_company": false,
      "core_variables": {},
      "custom_variables": {},
      "insert_unsubscribe_header": false,
      "allow_risky_contacts": false,
      "disable_bounce_protect": false,
      "limit_emails_per_company_override": {
        "daily_limit": 2
      },
      "cc_list": [
        "john@doe.com"
      ],
      "bcc_list": [
        "john@doe.com"
      ],
      "organization": "019f985c-62ff-7158-967d-71aaf0f64e82",
      "owned_by": "019f985c-6300-7bee-acb9-9a68dfa217ef",
      "ai_sdr_id": "019f985c-6300-7bee-acb9-9a69e7c17a0b",
      "provider_routing_rules": [
        {
          "action": "send",
          "recipient_esp": [
            "all"
          ],
          "sender_esp": [
            "all"
          ]
        }
      ]
    }
  ],
  "next_starting_after": "019f985c-92b0-777b-959b-90ca3d64319f"
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing Authorization header"
}

{
  "statusCode": 402,
  "error": "Payment Required",
  "message": "Workspace does not have an active paid plan"
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit

integer

The number of items to return

Required range: 1 <= x <= 100

Example:

10

starting_after

string

The ID of the last item in the previous page - used for pagination. You can use the value of the next_starting_after field from the previous response.

Example:

"01956fbd-0eb1-72db-a565-82977a586084"

string

Search by campaign name

Example:

"Summer Sale Campaign"

tag_ids

string

Filter campaigns by tag ids. Returns campaigns that have any of the specified tags assigned. You can specify multiple tag ids by separating them with a comma.

Example:

"019f985c-92b0-777b-959b-90c734332805,019f985c-92b0-777b-959b-90c88ef7f58c"

ai_sales_agent_id

string<uuid>

Filter campaigns by AI Sales Agent ID. Returns campaigns that were created by the specified AI Sales Agent.

Example:

"019f985c-92b0-777b-959b-90c9f0f0d2ce"

status

enum<number>

Filter campaigns by status using the campaign status enum value (e.g., ACTIVE, PAUSED).

Available options:

-99,

-1,

-2,

0,

1,

2,

3,

4

Example:

1

exclude_status

enum<number>

Exclude campaigns with this status using the campaign status enum value (e.g., exclude ACTIVE to list only campaigns that are not currently active).

Available options:

-99,

-1,

-2,

0,

1,

2,

3,

4

Example:

1

Response

The list of Campaign

items

Campaign · object[]

required

The list of Campaign

Show child attributes

next_starting_after

string

The filter for getting the next items after this one, this could either be a UUID, a timestamp, on an email depending on the specific API

Example:

"019f985c-92b0-777b-959b-90ca3d64319f"

Download all block list entries as CSV Create campaign

⌘I

Overview

Getting Started

Guides

Resources

Schemas

Authorizations

Query Parameters

Response