Campaigns

Resume a paused campaign (Tier 2: starts real calls)

POST /v1/campaigns/{campaign_id}/resume

Scope

campaigns:resume

Tier

Tier 2 (reaches or unlocks real people)

Data

Account data

Idempotency

Idempotency-Key: required

TIER 2. Starts real calls to real people. Needs the campaigns:resume scope AND the account switch tier2_campaign_resume_enabled (off unless DialerBee turned it on). Resuming a running campaign answers 200 and changes nothing. The body must be empty or {}.

Parameters

Request body

Empty, or {}.

JSON: EmptyRequest (optional)

Response

200: The campaign, now running.

Examples

Request example

curl

curl -sS -X POST \
  "https://app.dialerbee.com/api/v1/campaigns/cmp_0f8fad5b-d9cb-469f-a165-70867728950e/resume" \
  -H "Authorization: Bearer $DIALERBEE_API_KEY" \
  -H 'Idempotency-Key: 5f2b7c1e-8a3d-4c6f-9b0e-2d4a6c8e1f3a' \
  -H "Content-Type: application/json" \
  --data '{}'

Python (SDK)

from dialerbee import DialerBee

db = DialerBee()  # reads DIALERBEE_API_KEY from the environment

result = db.campaigns.resume(
    "cmp_0f8fad5b-d9cb-469f-a165-70867728950e",
    idempotency_key="5f2b7c1e-8a3d-4c6f-9b0e-2d4a6c8e1f3a",
)

Response example

200

{
  "id": "cmp_0f8fad5b-d9cb-469f-a165-70867728950e",
  "name": "Autumn renewals",
  "status": "running",
  "dialer_mode": "progressive",
  "created_at": "2026-09-29T09:15:00Z",
  "updated_at": "2026-09-29T09:20:00Z",
  "started_at": "2026-09-29T11:58:00Z",
  "completed_at": null
}

Error examples

409 campaign_not_paused

{
  "type": "https://docs.dialerbee.com/errors/campaign-not-paused",
  "title": "Campaign not paused",
  "status": 409,
  "detail": "Only a paused campaign can be resumed.",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "campaign_not_paused",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

409 registry_stale_blocked

{
  "type": "https://docs.dialerbee.com/errors/registry-stale-blocked",
  "title": "Launch blocked by do-not-call list status",
  "status": 409,
  "detail": "The campaign has leads in a country whose national do-not-call list is out of date, never loaded or not available, and the account has chosen to block a launch in that case.",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "registry_stale_blocked",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

403 tier_not_enabled

{
  "type": "https://docs.dialerbee.com/errors/tier-not-enabled",
  "title": "Capability not enabled",
  "status": 403,
  "detail": "This operation can reach or unlock real people.",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "tier_not_enabled",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

Errors

Objects

EmptyRequest

An empty JSON object.

Campaign