MOmonaco
Campaigns

Create a Campaign

Changed on

Creates a campaign that enrolls the contacts of the given audiences onto a template, routing sends according to distribution.

post/v1/campaigns/

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/campaigns/
  • Auth
    none declared

Request body

namestring required

Name of the campaign; must be unique within the organization

template_idstring uuid required

ID of the template enrolled contacts are placed on

audience_idsstring[] required

IDs of the audiences whose contacts are enrolled in this campaign

end_datestring date nullable

Date the campaign stops enrolling; must not be in the past

prioritizedboolean

Whether this campaign moves to the front of the organization's send queue, ahead of every non-prioritized campaign. Reserve it for time-sensitive sends, such as an upcoming conference. Prioritizing many campaigns at once dilutes the effect.

Example request

{
  "name": "Q3 Enterprise Outbound",
  "template_id": "550e8400-e29b-41d4-a716-446655440000",
  "audience_ids": [
    "550e8400-e29b-41d4-a716-446655440010"
  ],
  "distribution": {
    "mode": "percentage",
    "sender_ids": [
      "550e8400-e29b-41d4-a716-446655440001"
    ],
    "percentages": [
      {
        "sender_id": "550e8400-e29b-41d4-a716-446655440001",
        "percentage": 50
      }
    ]
  },
  "end_date": "2026-12-31",
  "rules_of_engagement": {
    "do_not_contact": {
      "enabled": true
    },
    "allow_sequence_stop_on_meeting_booked": {
      "enabled": true
    },
    "contact_cooldown": {
      "enabled": true,
      "days": 90
    },
    "account_cooldown": {
      "enabled": true,
      "days": 90
    },
    "max_contacts_in_sequence": {
      "enabled": true,
      "max_contacts": 3
    },
    "allow_non_account_owner_campaigns": {
      "enabled": true
    },
    "allow_stop_and_dismiss_on_account_status": {
      "enabled": true,
      "statuses": [
        "OPPORTUNITY",
        "CUSTOMER"
      ]
    },
    "exclude_sequences_on_account_status": {
      "enabled": true,
      "statuses": [
        "OPPORTUNITY",
        "CUSTOMER"
      ]
    }
  },
  "autopilot_settings": {
    "sender_rates": [
      {
        "sender_id": "550e8400-e29b-41d4-a716-446655440001",
        "daily_rate_target": 25
      }
    ]
  }
}

Response

Successful Response

Example response

{
  "data": {
    "id": "cmp_abc123",
    "name": "Q3 Enterprise Outbound",
    "end_date": "2026-12-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",
    "distribution": {
      "mode": "percentage",
      "sender_ids": [
        "550e8400-e29b-41d4-a716-446655440001"
      ],
      "percentages": [
        {
          "sender_id": "550e8400-e29b-41d4-a716-446655440001",
          "percentage": 50
        }
      ]
    },
    "rules_of_engagement": {
      "do_not_contact": {
        "enabled": true
      },
      "allow_sequence_stop_on_meeting_booked": {
        "enabled": true
      },
      "contact_cooldown": {
        "enabled": true,
        "days": 90
      },
      "account_cooldown": {
        "enabled": true,
        "days": 90
      },
      "max_contacts_in_sequence": {
        "enabled": true,
        "max_contacts": 3
      },
      "allow_non_account_owner_campaigns": {
        "enabled": true
      },
      "allow_stop_and_dismiss_on_account_status": {
        "enabled": true,
        "statuses": [
          "OPPORTUNITY",
          "CUSTOMER"
        ]
      },
      "exclude_sequences_on_account_status": {
        "enabled": true,
        "statuses": [
          "OPPORTUNITY",
          "CUSTOMER"
        ]
      }
    },
    "autopilot_settings": {
      "sender_rates": [
        {
          "sender_id": "550e8400-e29b-41d4-a716-446655440001",
          "daily_rate_target": 25
        }
      ]
    }
  }
}

Changes