Stop campaign

POST

/v1/convai/outbound-campaigns/campaigns/:campaign_id/stop

POST

/v1/convai/outbound-campaigns/campaigns/:campaign_id/stop

curl -X POST https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/campaign_id/stop

{
  "campaign_id": "string",
  "call_name": "string",
  "agent_id": "string",
  "channel_config": {
    "channel": "phone",
    "agent_phone_number_id": "string",
    "mode_config": {
      "ringing_timeout_secs": 60,
      "twilio_call_recording_enabled": false,
      "twilio_machine_detection": {
        "mode": "enable",
        "actions": [
          {
            "action": "hang_up",
            "answered_by": [
              "human"
            ]
          }
        ]
      },
      "mode": "voice"
    }
  },
  "status": "active",
  "policy": {
    "timezone": "string",
    "retry": {
      "retry_delay_seconds": 600,
      "max_short_retries": 1,
      "max_total_calls": 6,
      "max_callbacks": 2,
      "max_redirects": 2,
      "interval_placement": "start",
      "rotate_step_seconds": 900,
      "max_consecutive_failures_per_number": 1
    },
    "calling_periods": [
      {
        "weekdays": [
          1
        ],
        "intervals": [
          {
            "start": "string",
            "end": "string"
          }
        ]
      }
    ],
    "data_collection": {
      "callback_time": "string",
      "redirect_phone_number": "string",
      "stop": "string",
      "mappings": {}
    },
    "followup_context": {
      "call_type": true,
      "previous_conversation_id": true,
      "previous_summary": true,
      "previous_transcript": true
    }
  },
  "variant": "simple",
  "source": "ui",
  "outcome": {
    "type": "evaluation_criteria",
    "criteria_id": "string"
  },
  "created_at_unix": 1,
  "scheduled_time_unix": 1,
  "updated_at_unix": 1,
  "branch_id": "string",
  "environment": "string",
  "target_concurrency_limit": 1,
  "channel": "phone",
  "mode": "voice",
  "counts": {
    "leads": 1,
    "terminal_leads": 1,
    "open_attention": 1,
    "delivery": {
      "sent": 0,
      "delivered": 0,
      "read": 0,
      "replied": 0,
      "failed": 0
    }
  },
  "agent_name": ""
}

Stop an outbound campaign for good: queued calls are cancelled and no lead is called again. Returns 202 with the campaign stopping while calls already placed are still finishing.

Path parameters

campaign_idstringRequired

Response

Successful Response

campaign_idstring

call_namestring

The campaign's name.

agent_idstring

channel_configobject

statusenum

attention means an open attention item holds back some of the campaign’s calls while the rest go ahead. stopping means queued calls are cancelled and calls already placed are finishing.

policyobject

The policy the campaign took when it was created.

variantenum

Allowed values:

sourceenum or null

Whether the campaign was created in the app or through the API.

Allowed values:

outcomeobject or null

The result that counts as success for the campaign's calls.

created_at_unixinteger

scheduled_time_unixinteger or null

When the campaign starts calling; unset to start once created.

updated_at_unixinteger

branch_idstring or null

The agent branch the campaign calls with.

environmentstring or null

The environment the agent's environment variables resolve in.

target_concurrency_limitinteger or null

The most calls the campaign places at once.

channelenum

Allowed values:

modeenum

Allowed values:

countsobject

agent_namestringDefaults to

Errors

422

Unprocessable Entity Error

Path parameters

Headers

Response

Errors