Enroll Contacts in a Campaign

curl --request POST \
  --url https://api.monaco.com/v1/campaigns/{campaign_id}/enroll \
  --header 'Content-Type: application/json' \
  --data '
{
  "audience_name": "<string>",
  "contact_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.monaco.com/v1/campaigns/{campaign_id}/enroll"

payload = {
    "audience_name": "<string>",
    "contact_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    audience_name: '<string>',
    contact_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.monaco.com/v1/campaigns/{campaign_id}/enroll', 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}/enroll",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'audience_name' => '<string>',
    'contact_ids' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  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}/enroll"

	payload := strings.NewReader("{\n  \"audience_name\": \"<string>\",\n  \"contact_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.monaco.com/v1/campaigns/{campaign_id}/enroll")
  .header("Content-Type", "application/json")
  .body("{\n  \"audience_name\": \"<string>\",\n  \"contact_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.monaco.com/v1/campaigns/{campaign_id}/enroll")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"audience_name\": \"<string>\",\n  \"contact_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "success_count": 3,
    "failure_count": 1,
    "failure_reasons": [
      {
        "code": "contact_not_found",
        "description": "contact not found",
        "count": 1
      }
    ]
  },
  "meta": {
    "timestamp": "2026-07-09T10:30:00Z"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Campaigns

Enroll Contacts in a Campaign

Enrolls contacts into a campaign by creating a new audience named audience_name, attaching it to the campaign, and adding the contacts to it. The campaign must be active or paused. Sequences are created asynchronously; contacts already enrolled in the campaign are deduplicated then and still count as successes here. This always creates a new audience. Before calling this tool, if the campaign already has audiences, you MUST ask the user whether to create a new audience or add the contacts to an existing one via add_contacts_to_audience — and warn them that audiences can be shared, so adding contacts to a shared audience enrolls them in every campaign that uses it.

POST

campaigns

{campaign_id}

enroll

Enroll Contacts in a Campaign

curl --request POST \
  --url https://api.monaco.com/v1/campaigns/{campaign_id}/enroll \
  --header 'Content-Type: application/json' \
  --data '
{
  "audience_name": "<string>",
  "contact_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.monaco.com/v1/campaigns/{campaign_id}/enroll"

payload = {
    "audience_name": "<string>",
    "contact_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    audience_name: '<string>',
    contact_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.monaco.com/v1/campaigns/{campaign_id}/enroll', 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}/enroll",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'audience_name' => '<string>',
    'contact_ids' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  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}/enroll"

	payload := strings.NewReader("{\n  \"audience_name\": \"<string>\",\n  \"contact_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.monaco.com/v1/campaigns/{campaign_id}/enroll")
  .header("Content-Type", "application/json")
  .body("{\n  \"audience_name\": \"<string>\",\n  \"contact_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.monaco.com/v1/campaigns/{campaign_id}/enroll")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"audience_name\": \"<string>\",\n  \"contact_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "success_count": 3,
    "failure_count": 1,
    "failure_reasons": [
      {
        "code": "contact_not_found",
        "description": "contact not found",
        "count": 1
      }
    ]
  },
  "meta": {
    "timestamp": "2026-07-09T10:30:00Z"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Path Parameters

campaign_id

string<uuid>

required

Body

application/json

audience_name

string

required

Name for the new audience created to hold these contacts; pick something short and relevant to the enrollment. Must be unique within the organization — a duplicate name is rejected, so vary it and retry.

Required string length: 1 - 255

Example:

"Q3 Enterprise Outbound — July batch"

contact_ids

string<uuid>[]

required

IDs of the contacts to enroll in the campaign

Required array length: 1 - 10000 elements

Example:

["550e8400-e29b-41d4-a716-446655440020"]

Response

Successful Response

data

EnrollContactsInCampaignResponse · object

required

Aggregate outcome of enrolling contacts into a campaign.

Counts reflect contacts added to the campaign's new audience. Sequence creation happens asynchronously, so contacts already enrolled in the campaign are deduplicated later and still count as successes here.

Show child attributes

API

MCP

Enroll Contacts in a Campaign

Path Parameters

Body

Response