Update a Campaign
curl --request PATCH \
--url https://api.monaco.com/v1/campaigns/{campaign_id} \
--header 'Content-Type: application/json' \
--data '
{
"name": "Q3 Enterprise Outbound (revised)",
"end_date": "2026-12-31",
"audience_ids": [
"550e8400-e29b-41d4-a716-446655440010"
],
"distribution": {
"mode": "<string>",
"sender_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"percentages": [
{
"sender_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"percentage": 1
}
]
},
"rules_of_engagement": {
"max_contacts_in_sequence": {
"enabled": true,
"max_contacts": 3
}
},
"autopilot_settings": {
"sender_rates": [
{
"sender_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"daily_rate_target": 123
}
]
},
"status": "paused"
}
'import requests
url = "https://api.monaco.com/v1/campaigns/{campaign_id}"
payload = {
"name": "Q3 Enterprise Outbound (revised)",
"end_date": "2026-12-31",
"audience_ids": ["550e8400-e29b-41d4-a716-446655440010"],
"distribution": {
"mode": "<string>",
"sender_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"percentages": [
{
"sender_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"percentage": 1
}
]
},
"rules_of_engagement": { "max_contacts_in_sequence": {
"enabled": True,
"max_contacts": 3
} },
"autopilot_settings": { "sender_rates": [
{
"sender_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"daily_rate_target": 123
}
] },
"status": "paused"
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Q3 Enterprise Outbound (revised)',
end_date: '2026-12-31',
audience_ids: ['550e8400-e29b-41d4-a716-446655440010'],
distribution: {
mode: '<string>',
sender_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
percentages: [{sender_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', percentage: 1}]
},
rules_of_engagement: {max_contacts_in_sequence: {enabled: true, max_contacts: 3}},
autopilot_settings: {
sender_rates: [{sender_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', daily_rate_target: 123}]
},
status: 'paused'
})
};
fetch('https://api.monaco.com/v1/campaigns/{campaign_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.monaco.com/v1/campaigns/{campaign_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Q3 Enterprise Outbound (revised)',
'end_date' => '2026-12-31',
'audience_ids' => [
'550e8400-e29b-41d4-a716-446655440010'
],
'distribution' => [
'mode' => '<string>',
'sender_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'percentages' => [
[
'sender_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'percentage' => 1
]
]
],
'rules_of_engagement' => [
'max_contacts_in_sequence' => [
'enabled' => true,
'max_contacts' => 3
]
],
'autopilot_settings' => [
'sender_rates' => [
[
'sender_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'daily_rate_target' => 123
]
]
],
'status' => 'paused'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.monaco.com/v1/campaigns/{campaign_id}"
payload := strings.NewReader("{\n \"name\": \"Q3 Enterprise Outbound (revised)\",\n \"end_date\": \"2026-12-31\",\n \"audience_ids\": [\n \"550e8400-e29b-41d4-a716-446655440010\"\n ],\n \"distribution\": {\n \"mode\": \"<string>\",\n \"sender_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"percentages\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"percentage\": 1\n }\n ]\n },\n \"rules_of_engagement\": {\n \"max_contacts_in_sequence\": {\n \"enabled\": true,\n \"max_contacts\": 3\n }\n },\n \"autopilot_settings\": {\n \"sender_rates\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"daily_rate_target\": 123\n }\n ]\n },\n \"status\": \"paused\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.monaco.com/v1/campaigns/{campaign_id}")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Q3 Enterprise Outbound (revised)\",\n \"end_date\": \"2026-12-31\",\n \"audience_ids\": [\n \"550e8400-e29b-41d4-a716-446655440010\"\n ],\n \"distribution\": {\n \"mode\": \"<string>\",\n \"sender_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"percentages\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"percentage\": 1\n }\n ]\n },\n \"rules_of_engagement\": {\n \"max_contacts_in_sequence\": {\n \"enabled\": true,\n \"max_contacts\": 3\n }\n },\n \"autopilot_settings\": {\n \"sender_rates\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"daily_rate_target\": 123\n }\n ]\n },\n \"status\": \"paused\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.monaco.com/v1/campaigns/{campaign_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Q3 Enterprise Outbound (revised)\",\n \"end_date\": \"2026-12-31\",\n \"audience_ids\": [\n \"550e8400-e29b-41d4-a716-446655440010\"\n ],\n \"distribution\": {\n \"mode\": \"<string>\",\n \"sender_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"percentages\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"percentage\": 1\n }\n ]\n },\n \"rules_of_engagement\": {\n \"max_contacts_in_sequence\": {\n \"enabled\": true,\n \"max_contacts\": 3\n }\n },\n \"autopilot_settings\": {\n \"sender_rates\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"daily_rate_target\": 123\n }\n ]\n },\n \"status\": \"paused\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "cmp_abc123",
"name": "Q3 Enterprise Outbound (revised)",
"status": "paused",
"prioritized": true,
"end_date": "2027-01-31",
"template_id": "seqt_789ghi",
"template_name": "Enterprise Onboarding",
"audiences": [
{
"id": "aud_abc123",
"name": "Enterprise West"
}
],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-05-10T14:22:00Z"
},
"meta": {
"timestamp": "2026-05-10T14:22:00Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Campaigns
Update a Campaign
Updates a campaign’s content fields (name, end_date, audience_ids, distribution, rules_of_engagement, autopilot_settings) and/or transitions its lifecycle via status (active resumes, paused halts, completed ends it, archived permanently stops it and is terminal). Supplying audience_ids replaces the campaign’s audience set — see that field to add or remove an audience. Returns the refreshed campaign.
PATCH
/
v1
/
campaigns
/
{campaign_id}
Update a Campaign
curl --request PATCH \
--url https://api.monaco.com/v1/campaigns/{campaign_id} \
--header 'Content-Type: application/json' \
--data '
{
"name": "Q3 Enterprise Outbound (revised)",
"end_date": "2026-12-31",
"audience_ids": [
"550e8400-e29b-41d4-a716-446655440010"
],
"distribution": {
"mode": "<string>",
"sender_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"percentages": [
{
"sender_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"percentage": 1
}
]
},
"rules_of_engagement": {
"max_contacts_in_sequence": {
"enabled": true,
"max_contacts": 3
}
},
"autopilot_settings": {
"sender_rates": [
{
"sender_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"daily_rate_target": 123
}
]
},
"status": "paused"
}
'import requests
url = "https://api.monaco.com/v1/campaigns/{campaign_id}"
payload = {
"name": "Q3 Enterprise Outbound (revised)",
"end_date": "2026-12-31",
"audience_ids": ["550e8400-e29b-41d4-a716-446655440010"],
"distribution": {
"mode": "<string>",
"sender_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"percentages": [
{
"sender_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"percentage": 1
}
]
},
"rules_of_engagement": { "max_contacts_in_sequence": {
"enabled": True,
"max_contacts": 3
} },
"autopilot_settings": { "sender_rates": [
{
"sender_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"daily_rate_target": 123
}
] },
"status": "paused"
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Q3 Enterprise Outbound (revised)',
end_date: '2026-12-31',
audience_ids: ['550e8400-e29b-41d4-a716-446655440010'],
distribution: {
mode: '<string>',
sender_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
percentages: [{sender_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', percentage: 1}]
},
rules_of_engagement: {max_contacts_in_sequence: {enabled: true, max_contacts: 3}},
autopilot_settings: {
sender_rates: [{sender_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', daily_rate_target: 123}]
},
status: 'paused'
})
};
fetch('https://api.monaco.com/v1/campaigns/{campaign_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.monaco.com/v1/campaigns/{campaign_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Q3 Enterprise Outbound (revised)',
'end_date' => '2026-12-31',
'audience_ids' => [
'550e8400-e29b-41d4-a716-446655440010'
],
'distribution' => [
'mode' => '<string>',
'sender_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'percentages' => [
[
'sender_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'percentage' => 1
]
]
],
'rules_of_engagement' => [
'max_contacts_in_sequence' => [
'enabled' => true,
'max_contacts' => 3
]
],
'autopilot_settings' => [
'sender_rates' => [
[
'sender_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'daily_rate_target' => 123
]
]
],
'status' => 'paused'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.monaco.com/v1/campaigns/{campaign_id}"
payload := strings.NewReader("{\n \"name\": \"Q3 Enterprise Outbound (revised)\",\n \"end_date\": \"2026-12-31\",\n \"audience_ids\": [\n \"550e8400-e29b-41d4-a716-446655440010\"\n ],\n \"distribution\": {\n \"mode\": \"<string>\",\n \"sender_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"percentages\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"percentage\": 1\n }\n ]\n },\n \"rules_of_engagement\": {\n \"max_contacts_in_sequence\": {\n \"enabled\": true,\n \"max_contacts\": 3\n }\n },\n \"autopilot_settings\": {\n \"sender_rates\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"daily_rate_target\": 123\n }\n ]\n },\n \"status\": \"paused\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.monaco.com/v1/campaigns/{campaign_id}")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Q3 Enterprise Outbound (revised)\",\n \"end_date\": \"2026-12-31\",\n \"audience_ids\": [\n \"550e8400-e29b-41d4-a716-446655440010\"\n ],\n \"distribution\": {\n \"mode\": \"<string>\",\n \"sender_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"percentages\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"percentage\": 1\n }\n ]\n },\n \"rules_of_engagement\": {\n \"max_contacts_in_sequence\": {\n \"enabled\": true,\n \"max_contacts\": 3\n }\n },\n \"autopilot_settings\": {\n \"sender_rates\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"daily_rate_target\": 123\n }\n ]\n },\n \"status\": \"paused\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.monaco.com/v1/campaigns/{campaign_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Q3 Enterprise Outbound (revised)\",\n \"end_date\": \"2026-12-31\",\n \"audience_ids\": [\n \"550e8400-e29b-41d4-a716-446655440010\"\n ],\n \"distribution\": {\n \"mode\": \"<string>\",\n \"sender_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"percentages\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"percentage\": 1\n }\n ]\n },\n \"rules_of_engagement\": {\n \"max_contacts_in_sequence\": {\n \"enabled\": true,\n \"max_contacts\": 3\n }\n },\n \"autopilot_settings\": {\n \"sender_rates\": [\n {\n \"sender_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"daily_rate_target\": 123\n }\n ]\n },\n \"status\": \"paused\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "cmp_abc123",
"name": "Q3 Enterprise Outbound (revised)",
"status": "paused",
"prioritized": true,
"end_date": "2027-01-31",
"template_id": "seqt_789ghi",
"template_name": "Enterprise Onboarding",
"audiences": [
{
"id": "aud_abc123",
"name": "Enterprise West"
}
],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-05-10T14:22:00Z"
},
"meta": {
"timestamp": "2026-05-10T14:22:00Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Path Parameters
Body
application/json
Content edits and status transitions for a campaign.
Any combination of content fields may be supplied. When status is set it
is routed to the matching lifecycle transition (pause / resume / complete / archive).
New name for the campaign; must be unique within the organization
Example:
"Q3 Enterprise Outbound (revised)"
New end date; must not be in the past
Example:
"2026-12-31"
The complete set of audiences for this campaign. This REPLACES the current set — to add or remove an audience, fetch the campaign first (get_campaign) and submit the full desired list. Any audience you omit is detached. Changes trigger re-enrollment.
Example:
["550e8400-e29b-41d4-a716-446655440010"]
Split sends across named senders by fixed percentages that sum to 100.
- PercentageDistribution
- AccountOwnerDistribution
Show child attributes
Show child attributes
Per-rule overrides on the org's default rules of engagement
Show child attributes
Show child attributes
Example:
{
"max_contacts_in_sequence": { "enabled": true, "max_contacts": 3 }
}
Replacement autopilot roster. Senders listed here auto-send up to their daily cap; senders in distribution but omitted here require manual approval per send. An empty sender_rates list moves every sender to supervised.
Show child attributes
Show child attributes
Target lifecycle status. paused halts new sends, active resumes a paused campaign, completed stops all of its sequences (terminal), and archived permanently stops the campaign and halts all of its active/paused sequences — terminal and cannot be reversed via the public API.
Available options:
active, paused, completed, archived Example:
"paused"
⌘I