Open Menace Voice

Start Campaign

Start dialing contacts in a campaign

1 min read

post/api/v1/campaign/{campaign_id}/start

Request example

curl --request POST \
  --url https://voice.menaceui.com/api/v1/campaign/{campaign_id}/start \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>'

Response

{
  "id": 1,
  "name": "<string>",
  "workflow_id": 1,
  "workflow_name": "<string>",
  "state": "<string>",
  "source_type": "<string>",
  "source_id": "<string>",
  "total_rows": 1,
  "processed_rows": 1,
  "failed_rows": 1,
  "created_at": "2026-08-10T12:00:00Z",
  "started_at": "2026-08-10T12:00:00Z",
  "completed_at": "2026-08-10T12:00:00Z",
  "retry_config": {
    "enabled": true,
    "max_retries": 1,
    "retry_delay_seconds": 1,
    "retry_on_busy": true,
    "retry_on_no_answer": true,
    "retry_on_voicemail": true
  },
  "max_concurrency": 1,
  "schedule_config": {
    "enabled": true,
    "timezone": "<string>",
    "slots": [
      {
        "day_of_week": 1,
        "start_time": "<string>",
        "end_time": "<string>"
      }
    ]
  },
  "circuit_breaker": {
    "enabled": false,
    "failure_threshold": 0.5,
    "window_seconds": 120,
    "min_calls_in_window": 5
  },
  "executed_count": 0,
  "total_queued_count": 0,
  "parent_campaign_id": 1,
  "redialed_campaign_id": 1,
  "telephony_configuration_id": 1,
  "telephony_configuration_name": "<string>",
  "logs": [
    {
      "ts": "<string>",
      "level": "<string>",
      "event": "<string>",
      "message": "<string>",
      "details": {}
    }
  ]
}

post/api/v1/campaign/{campaign_id}/start

Transitions the campaign from draft or paused to running. Menace Voice begins dialing contacts up to the configured max_concurrency.

Path parameters

campaign_idintegerrequired#

Headers

authorizationstring · null#

X-API-Keystring · null#

Responses

application/json

Successful Response

idintegerrequired#

namestringrequired#

workflow_idintegerrequired#

workflow_namestringrequired#

statestringrequired#

source_typestringrequired#

source_idstringrequired#

total_rowsinteger · nullrequired#

Show child attributes

processed_rowsintegerrequired#

failed_rowsintegerrequired#

created_atstringrequired#

started_atstring · nullrequired#

Show child attributes

completed_atstring · nullrequired#

Show child attributes

retry_configobjectrequired#

Show child attributes

enabledbooleanrequired#

max_retriesintegerrequired#

retry_delay_secondsintegerrequired#

retry_on_busybooleanrequired#

retry_on_no_answerbooleanrequired#

retry_on_voicemailbooleanrequired#

max_concurrencyinteger · null#

Show child attributes

schedule_configobject · null#

Show child attributes

circuit_breakerobject · null#

Show child attributes

executed_countinteger#

Default: 0

total_queued_countinteger#

Default: 0

parent_campaign_idinteger · null#

Show child attributes

redialed_campaign_idinteger · null#

Show child attributes

telephony_configuration_idinteger · null#

Show child attributes

telephony_configuration_namestring · null#

Show child attributes

logsobject[]#

Show child attributes

tsstringrequired#

levelstringrequired#

eventstringrequired#

messagestringrequired#

detailsobject · null#

Show child attributes

Update Campaign Pause Campaign