# CloudTalk Dialer API

**Canonical:** https://apis.io/apis/cloudtalk/cloudtalk-dialer-api/  
**Provider:** CloudTalk — https://apis.io/providers/cloudtalk/  
**Base URL:** https://my.cloudtalk.io/api  
**Documentation:** https://developers.cloudtalk.io/

CloudTalk Dialer API is one of 15 APIs that [CloudTalk](https://apis.io/providers/cloudtalk/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Sales Dialer. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

Partner API for the CloudTalk sales dialer — campaigns, campaign contacts, call scripts, surveys, disposition buttons, statistics and data exports. The Dialer is a newly released product surface: depending on your account's rollout stage, campaigns managed through this API may not yet be visible in your CloudTalk Dashboard. The legacy campaigns API under `/campaigns` is a different product and is not affected. Authentication is the same HTTP Basic scheme as the rest of the API — your API Access Key ID as the username and API Access Key Secret as the password. This surface differs from the rest of the CloudTalk API in three ways: - **Base URL** `https://api.cloudtalk.io/v1` (not `my.cloudtalk.io/api`). - **Responses** never use the `responseData` envelope: list endpoints return `{ data, meta }` with cursor pagination (`meta.nextCursor` — pass it back as `cursor` to page forward), single resources return the object directly, and some sub-collections return plain arrays. - **Errors** return `{ statusCode, message, error, correlationId, subErrors? }` — except `401`, which is answered by the authentication layer in front of the host as `{ code, message }`. Quote the `correlationId` when contacting support. Rate limiting is per company in a dedicated budget of 60 requests per minute, separate from the core API's quota.

## Operations (27)

| Method | Path | Summary |
|---|---|---|
| POST | `/dialer/campaigns` | Create a dialer campaign |
| GET | `/dialer/campaigns` | List dialer campaigns |
| GET | `/dialer/campaigns/{campaignId}` | Get a dialer campaign |
| PATCH | `/dialer/campaigns/{campaignId}` | Update a dialer campaign |
| DELETE | `/dialer/campaigns/{campaignId}` | Delete a dialer campaign |
| PUT | `/dialer/campaigns/{campaignId}/associations` | Replace a campaign's associations |
| GET | `/dialer/campaigns/{campaignId}/associations` | Get a campaign's associations |
| PUT | `/dialer/campaigns/{campaignId}/disposition-buttons` | Replace a campaign's disposition buttons |
| GET | `/dialer/campaigns/{campaignId}/disposition-buttons` | Get a campaign's disposition buttons |
| GET | `/dialer/disposition-tags` | List disposition tags |
| GET | `/dialer/campaigns/{campaignId}/statistics` | Get a campaign's statistics |
| GET | `/dialer/campaigns/{campaignId}/contacts` | List a campaign's contacts |
| GET | `/dialer/campaigns/{campaignId}/contacts/next` | Peek at the next contacts to be dialed |
| GET | `/dialer/campaigns/{campaignId}/contacts/{campaignContactId}` | Get one campaign contact |
| POST | `/dialer/campaigns/{campaignId}/exports` | Request a campaign data export |
| GET | `/dialer/exports/{jobId}` | Get an export job's status |
| GET | `/dialer/exports/{jobId}/download` | Get a download link for a completed export |
| POST | `/dialer/scripts` | Create a call script |
| GET | `/dialer/scripts` | List call scripts |
| GET | `/dialer/scripts/{scriptId}` | Get a call script |
| PATCH | `/dialer/scripts/{scriptId}` | Update a call script |
| DELETE | `/dialer/scripts/{scriptId}` | Archive a call script |
| POST | `/dialer/surveys` | Create a survey |
| GET | `/dialer/surveys` | List surveys |
| GET | `/dialer/surveys/{surveyId}` | Get a survey |
| PATCH | `/dialer/surveys/{surveyId}` | Rename or archive a survey |
| PUT | `/dialer/surveys/{surveyId}/questions` | Replace a survey's questions |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cloudtalk/refs/heads/main/openapi/cloudtalk-dialer-api-openapi.yml
- **Documentation** — https://developers.cloudtalk.io/
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/cloudtalk/refs/heads/main/authentication/cloudtalk-authentication.yml

## Other CloudTalk APIs (12)

- [CloudTalk Agents API](https://apis.io/apis/cloudtalk/cloudtalk-agents-api/)
- [CloudTalk Bulks API](https://apis.io/apis/cloudtalk/cloudtalk-bulks-api/)
- [CloudTalk Calls API](https://apis.io/apis/cloudtalk/cloudtalk-calls-api/)
- [CloudTalk Campaigns API](https://apis.io/apis/cloudtalk/cloudtalk-campaigns-api/)
- [CloudTalk Contacts API](https://apis.io/apis/cloudtalk/cloudtalk-contacts-api/)
- [CloudTalk Conversation Intelligence API](https://apis.io/apis/cloudtalk/cloudtalk-conversation-intelligence-api/)
- [CloudTalk CueCard API](https://apis.io/apis/cloudtalk/cloudtalk-cuecard-api/)
- [CloudTalk Groups API](https://apis.io/apis/cloudtalk/cloudtalk-groups-api/)
- [CloudTalk Numbers API](https://apis.io/apis/cloudtalk/cloudtalk-numbers-api/)
- [CloudTalk Sms API](https://apis.io/apis/cloudtalk/cloudtalk-sms-api/)
- [CloudTalk VoiceAgent API](https://apis.io/apis/cloudtalk/cloudtalk-voiceagent-api/)
- [CloudTalk Contact tags API](https://apis.io/apis/cloudtalk/cloudtalk-contact-tags-api/)

## Tags

Sales Dialer

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cloudtalk/cloudtalk-dialer-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cloudtalk/.