Campaigns

curl -X POST "https://api.talkturo.com/api/crm/campaigns" \
  -H "Authorization: Bearer tk_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q4 reactivation campaign",
    "assistantId": "asst_7d92f4a1",
    "companyId": "cmp_31ab82d9",
    "fromNumberIds": [
      "9f8d1c5f-3c31-45b7-8ef1-72e4b53e6b11"
    ],
    "scheduledStartAt": "2026-09-15T14:00:00Z",
    "callWindowStart": "09:00",
    "callWindowEnd": "17:00",
    "callWindowTimezone": "America/New_York",
    "maxConcurrentCalls": 4,
    "maxAttemptsPerContact": 3,
    "retryDelayMinutes": 120
  }'

{
  "id": "camp_4bc91e27",
  "name": "Q4 reactivation campaign",
  "status": "scheduled",
  "assistantId": "asst_7d92f4a1",
  "companyId": "cmp_31ab82d9",
  "fromNumberIds": [
    "9f8d1c5f-3c31-45b7-8ef1-72e4b53e6b11"
  ],
  "scheduledStartAt": "2026-09-15T14:00:00Z",
  "callWindowStart": "09:00",
  "callWindowEnd": "17:00",
  "callWindowTimezone": "America/New_York",
  "maxConcurrentCalls": 4,
  "maxAttemptsPerContact": 3,
  "retryDelayMinutes": 120
}

Run outbound campaigns at scale

Campaigns are Talkturo's outbound calling system. A campaign pairs an AI assistant with a contact list, a set of phone numbers, and calling rules, then dials contacts automatically according to the schedule and retry behavior you define.

The campaign engine checks for work every 30 seconds. When a campaign is active and inside its call window, the engine pulls eligible contacts from the queue and starts calls based on your campaign settings.

How campaigns work

A campaign moves through a predictable lifecycle. You set it up once, enroll contacts, define the rules, and then let the dialing engine work through the queue.

Campaign statuses

Campaigns use a small set of statuses that tell you whether they are ready, waiting, dialing, or finished.

Understand status transitions

Most campaign behavior comes down to a few important state changes. Knowing these transitions helps you predict when a campaign will start, pause, or stop.

Common transitions

What completion means

A campaign reaches completed when it has no more work to process. In practice, that means every enrolled contact has been called, skipped, failed, or otherwise moved out of the active queue.

If your workflow disables automatic completion, the campaign may stay out of the normal completion path even after the queue is empty. Use real-time campaign stats to confirm whether work is still pending.

Create a campaign

You need four required fields to create a valid campaign. Everything else controls scheduling, concurrency, retries, and integrations.

Required fields

Optional fields

Example create request

Campaign API

Use these endpoints to create campaigns, manage contacts, control execution, and read live stats.

Work with campaign contacts

Campaigns do not dial CRM contacts directly. They dial campaign contacts, which are enrolled records tracked inside a specific campaign.

Enrollment methods

You can add contacts to a campaign in three ways:

• All eligible contacts through audience mode
• Manual selection by contact IDs
• Inline create and enroll when you need to add a new contact directly into the campaign

If a contact is marked DNC, Talkturo still records the enrollment but marks that contact as skipped automatically.

Contact statuses

Each enrolled contact moves through its own delivery state as the campaign progresses.

Queue ordering

When multiple contacts are ready at the same time, Talkturo processes them in this order:

1. Higher priority first
2. Earlier created_at first when priority is the same

That ordering is equivalent to priority DESC, created_at ASC. If you rely on careful sequencing, set contact priority before the campaign begins.

Credits and campaign execution

Campaigns need credits available at launch time and while they are running. Credits affect both whether a campaign can start and whether it can keep dialing.

When a scheduled campaign reaches its launch time, Talkturo checks account credits before moving it to running. If the account does not have enough credits, the campaign moves to paused instead of dialing contacts.

After you add credits, suspended phone numbers are reactivated. You can then resume the paused campaign and continue processing the existing queue.

Related pages