campaigns.start

Start dialling.

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

Reference

POST/api/v1/campaigns/{campaign_id}/start

Auth

API key in X-API-Key

Content

application/json

Returns

200 · CampaignResponse

Start campaign execution

Arguments

Argument	In	Type	Required	Description
campaign_id	path	integer	required

Example request

curl -X POST "https://api.decibyl.ai/api/v1/campaigns/<campaign_id>/start" \
  -H "X-API-Key: dcb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"consent_attested":false}'

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-09-14T09:30:00Z",
  "started_at": "2026-09-14T09:30:00Z",
  "completed_at": "2026-09-14T09:30: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",
  "consent_attested_at": "2026-09-14T09:30:00Z",
  "consent_attested_by": 1,
  "logs": [
    {
      "ts": "string",
      "level": "string",
      "event": "string",
      "message": "string",
      "details": {}
    }
  ]
}

Errors

Status	When
404	Not found
422	Validation Error