Retry single call

Immediately retry a campaign call by phone number

POST /organizations/{organization_id}/projects/{project_id}/campaigns/{campaign_id}/retry-call

cURL

curl -X POST "https://backend.botcadence.com/organizations/ORG_ID/projects/PROJECT_ID/campaigns/CAMPAIGN_ID/retry-call" \
  -H "X-API-Key: bot_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "[phone]"
  }'

const response = await fetch(
  `https://backend.botcadence.com/organizations/${organizationId}/projects/${projectId}/campaigns/${campaignId}/retry-call`,
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.BOTCADENCE_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ phone_number: "[phone]" }),
  }
);

import os
import requests

response = requests.post(
    f"https://backend.botcadence.com/organizations/{organization_id}/projects/{project_id}/campaigns/{campaign_id}/retry-call",
    headers={
        "X-API-Key": os.environ["BOTCADENCE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={"phone_number": "[phone]"},
)

200

{
  "status": "success",
  "message": "Call initiated to [phone]",
  "data": {
    "success": true,
    "campaign_queue_id": "665f1a2b3c4d5e6f7a8b9c0d",
    "message": "Call initiated to [phone]"
  },
  "status_code": 200
}

{
  "status": "error",
  "message": "Campaign has no phone numbers (caller ID) configured",
  "data": null,
  "status_code": 400
}

Retries a specific call for a phone number on the campaign. The call is dispatched immediately (bypasses the scheduled orchestrator).

Authentication

X-API-Key · string · required

Project API key for this organization and project. Format: bot_live_…

Path parameters

organization_id · string · required

Organization ID. Must match the API key.

project_id · string · required

Project ID. Must match the API key.

campaign_id · string · required

Campaign ID.

Body

phone_number · string · required

Phone number to call again.

Response

success · boolean · required

true when the retry was queued.

campaign_queue_id · string · required

ID of the new outbound queue attempt.

message · string · required

Human-readable confirmation.

Errors

400 · Bad Request

Campaign not ready, invalid phone, or retry failed.

401 · Unauthorized

Missing, invalid, or revoked API key.

403 · Forbidden

API key is not authorized for this organization or project.

cURL

curl -X POST "https://backend.botcadence.com/organizations/ORG_ID/projects/PROJECT_ID/campaigns/CAMPAIGN_ID/retry-call" \
  -H "X-API-Key: bot_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "[phone]"
  }'

const response = await fetch(
  `https://backend.botcadence.com/organizations/${organizationId}/projects/${projectId}/campaigns/${campaignId}/retry-call`,
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.BOTCADENCE_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ phone_number: "[phone]" }),
  }
);

import os
import requests

response = requests.post(
    f"https://backend.botcadence.com/organizations/{organization_id}/projects/{project_id}/campaigns/{campaign_id}/retry-call",
    headers={
        "X-API-Key": os.environ["BOTCADENCE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={"phone_number": "[phone]"},
)

200

{
  "status": "success",
  "message": "Call initiated to [phone]",
  "data": {
    "success": true,
    "campaign_queue_id": "665f1a2b3c4d5e6f7a8b9c0d",
    "message": "Call initiated to [phone]"
  },
  "status_code": 200
}

{
  "status": "error",
  "message": "Campaign has no phone numbers (caller ID) configured",
  "data": null,
  "status_code": 400
}