Skip to main content
Glama

Create a campaign

create_campaign

Create a draft outbound campaign: agent, caller-id numbers, contact list, purpose, consent_basis (existing_customer | explicit_consent), calling windows, retry policy (or a preset: sales, collections, single_attempt), concurrency and optional schedule. It starts only when launched with launch_campaign.

Input Schema

NameRequiredDescriptionDefault
nameYes
ends_atNo
purposeYesOptional, free-form outbound purpose, recorded when sent; no purpose or token is ever refused. The documented advisory catalog is: appointment, booking_confirmation, callback_requested, customer_outreach, delivery_notification, ops_alert, other, payment_reminder, personal_errand, reservation, status_check, support.
agent_idYes
languageNo
time_zoneNoIANA time zone (default UTC), matched and stored like a contact's time_zone: ignoring case, another spelling of a zone stored as the zone it names, an offset such as UTC-5 refused.
project_idYes
retry_policyNo
consent_basisYes
time_zone_modeNo
calling_windowsNo{weekday: [{start: 'HH:MM', end: 'HH:MM'}]}; defaults per destination country.
contact_list_idYes
from_number_idsYes
max_concurrencyNo
organization_idNoOptional. Defaults to the authenticated workspace; when supplied it must be that workspace's id.
scheduled_start_atNo
retry_policy_presetNo
reserved_concurrencyNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / purpose / description
      Previous value: -"Required, free-form outbound purpose declaration -- never refused for being novel. Any non-empty token is accepted; the documented advisory catalog is: appointment, booking_confirmation, callback_requested, customer_outreach, delivery_notification, ops_alert, other, payment_reminder, personal_errand, reservation, status_check, support."New value: +"Optional, free-form outbound purpose, recorded when sent; no purpose or token is ever refused. The documented advisory catalog is: appointment, booking_confirmation, callback_requested, customer_outreach, delivery_notification, ops_alert, other, payment_reminder, personal_errand, reservation, status_check, support."
  2. First observed

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare non-read-only, non-destructive, non-idempotent, so the safety profile is covered; the description adds genuinely new behavioral context by establishing that creation yields an inert draft and that outbound activity requires a separate launch. It does not disclose validation behavior, whether creation can fail on number/consent mismatches, or permission requirements, which keeps it from a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and the critical launch caveat are front-loaded, and the whole definition is two sentences with no filler. The middle sentence is a long comma-run list that is dense to parse but each element carries information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 7-required-parameter mutation with nested objects, 22% schema coverage and no output schema, the description covers the conceptual surface but leaves real gaps: it never says what is returned (presumably a campaign id needed for launch_campaign) or how concurrency/reserved_concurrency and time_zone_mode interact. Adequate to attempt a call, not complete enough to call confidently without opening the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With only 22% schema coverage across 18 parameters and nested objects, the description usefully names the major configuration groups and spells out the consent_basis values and the three retry_policy presets. However, it says nothing about the distinction between max_concurrency and reserved_concurrency, time_zone_mode, language, ends_at, organization_id scoping, or the shape of retry_policy — leaving several parameters undocumented in both places.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource+state ('Create a draft outbound campaign') and then enumerates exactly what the draft configures: agent, caller-id numbers, contact list, purpose, consent basis, calling windows, retry policy, concurrency, schedule. This is clearly distinct from launch_campaign, update_campaign, and get_campaign in the sibling set.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly states the lifecycle boundary: the campaign does not run until 'launched with launch_campaign,' which routes the agent to the correct follow-up tool. It gives no guidance on when to prefer update_campaign for an existing campaign or on prerequisite policy checks (evaluate_outbound_policy / authorize_outbound), so it stops short of full alternative coverage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.