Activate(start), or resume a campaign
curl --request POST \
--url https://api.instantly.ai/api/v2/campaigns/{id}/activate \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.instantly.ai/api/v2/campaigns/{id}/activate"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.instantly.ai/api/v2/campaigns/{id}/activate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.instantly.ai/api/v2/campaigns/{id}/activate")
.header("Authorization", "Bearer <token>")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.instantly.ai/api/v2/campaigns/{id}/activate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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/{id}/activate"
req, _ := http.NewRequest("POST", 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))
}{
"id": "01a1ff7c-b286-7182-9aec-db2ab02ec115",
"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-11-21T19:02:04.678Z",
"timestamp_updated": "2026-11-21T19:02:04.678Z",
"pl_value": 100,
"is_evergreen": false,
"sequences": [
{
"steps": [
{
"type": "email",
"delay": 2,
"variants": [
{
"subject": "Hello {{firstName}}",
"body": "Hey {{firstName}},<br/><br/>I 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": [
"01a1ff7c-b286-7182-9aec-db2bc92cc8ca"
],
"link_tracking": true,
"open_tracking": true,
"stop_on_auto_reply": false,
"daily_max_leads": 100,
"prioritize_new_leads": false,
"auto_variant_select": {
"trigger": "click_rate"
},
"match_lead_esp": false,
"not_sending_status": 2,
"stop_for_company": false,
"core_variables": {},
"custom_variables": {},
"insert_unsubscribe_header": false,
"same_domain_sender_failover": false,
"allow_risky_contacts": false,
"disable_bounce_protect": false,
"limit_emails_per_company_override": {
"mode": "custom",
"daily_limit": 3,
"scope": "per_campaign"
},
"cc_list": [
"john@doe.com"
],
"bcc_list": [
"john@doe.com"
],
"organization": "01a1ff7c-b286-7182-9aec-db2cbdfef03a",
"owned_by": "01a1ff7c-b286-7182-9aec-db2d7c39b16b",
"created_by": "01a1ff7c-b286-7182-9aec-db2e056a786c",
"ai_sdr_id": "01a1ff7c-b286-7182-9aec-db2f927db549",
"provider_routing_rules": [
{
"action": "send",
"recipient_esp": [
"all"
],
"sender_esp": [
"all"
]
}
]
}{
"statusCode": 400,
"error": "Bad Request",
"message": "body must have required property 'name'",
"code": "FST_ERR_VALIDATION"
}{
"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"
}Campaign
Activate(start), or resume a campaign
Activate(start), or resume a campaign. Subsequences that stopped sending because the campaign had no usable sending accounts resume with it.
Requires one of the following scopes: campaigns:update, campaigns:all, all:update, all:all
POST
/
api
/
v2
/
campaigns
/
{id}
/
activate
Activate(start), or resume a campaign
curl --request POST \
--url https://api.instantly.ai/api/v2/campaigns/{id}/activate \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.instantly.ai/api/v2/campaigns/{id}/activate"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.instantly.ai/api/v2/campaigns/{id}/activate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.instantly.ai/api/v2/campaigns/{id}/activate")
.header("Authorization", "Bearer <token>")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.instantly.ai/api/v2/campaigns/{id}/activate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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/{id}/activate"
req, _ := http.NewRequest("POST", 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))
}{
"id": "01a1ff7c-b286-7182-9aec-db2ab02ec115",
"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-11-21T19:02:04.678Z",
"timestamp_updated": "2026-11-21T19:02:04.678Z",
"pl_value": 100,
"is_evergreen": false,
"sequences": [
{
"steps": [
{
"type": "email",
"delay": 2,
"variants": [
{
"subject": "Hello {{firstName}}",
"body": "Hey {{firstName}},<br/><br/>I 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": [
"01a1ff7c-b286-7182-9aec-db2bc92cc8ca"
],
"link_tracking": true,
"open_tracking": true,
"stop_on_auto_reply": false,
"daily_max_leads": 100,
"prioritize_new_leads": false,
"auto_variant_select": {
"trigger": "click_rate"
},
"match_lead_esp": false,
"not_sending_status": 2,
"stop_for_company": false,
"core_variables": {},
"custom_variables": {},
"insert_unsubscribe_header": false,
"same_domain_sender_failover": false,
"allow_risky_contacts": false,
"disable_bounce_protect": false,
"limit_emails_per_company_override": {
"mode": "custom",
"daily_limit": 3,
"scope": "per_campaign"
},
"cc_list": [
"john@doe.com"
],
"bcc_list": [
"john@doe.com"
],
"organization": "01a1ff7c-b286-7182-9aec-db2cbdfef03a",
"owned_by": "01a1ff7c-b286-7182-9aec-db2d7c39b16b",
"created_by": "01a1ff7c-b286-7182-9aec-db2e056a786c",
"ai_sdr_id": "01a1ff7c-b286-7182-9aec-db2f927db549",
"provider_routing_rules": [
{
"action": "send",
"recipient_esp": [
"all"
],
"sender_esp": [
"all"
]
}
]
}{
"statusCode": 400,
"error": "Bad Request",
"message": "body must have required property 'name'",
"code": "FST_ERR_VALIDATION"
}{
"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
Response
The requested Campaign
A campaign that can be sent to a list of recipients
Send a follow-up from another account on the same domain when the account that last emailed the lead has hit its daily sending limit or slow ramp limit. Off by default: the follow-up waits for that account. API only; null means off.
When on:
- A switch happens only when that account hits its daily sending limit or slow ramp limit, or is removed from the campaign. For any other reason, such as the gap between sends, the follow-up waits.
- The other account must be in this campaign and on the exact same domain.
mail.acme.comandacme.comare different domains. - The follow-up stays in the same email thread.
- Each lead gets emails from at most 2 accounts in this campaign, including subsequences. The account that emailed the lead most recently is tried first.
- Counting starts when you turn this on. The account that last emailed the lead is the first of the 2; earlier accounts do not count.
- If none of the lead's accounts can send, the follow-up waits. It does not use a third account or another domain, except in the cases below.
- For this campaign, the workspace setting "Sticky sending accounts for leads" is ignored.
Exceptions:
- If every account the lead can use was removed from the campaign, a sender is picked as usual. It may be on another domain and may start a new thread. This keeps the campaign from stalling.
- In rare cases a lead can get a third account: when the lead enters or leaves a subsequence, is moved or re-added to the campaign, when this setting is turned off and on again, or when a send is interrupted before it is confirmed.
Example:
false