Skip to main content
POST
Create a call script
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.

Authorizations

Authorization
string
header
required

HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).

Body

application/json

Body of the create-script call. Unknown fields are silently dropped.

name
string
required

Display name.

Required string length: 1 - 255
Example:

"Summer promo pitch"

body
string
required

Script content; supports {{merge}} fields.

Minimum string length: 1
Example:

"Hi {{first_name}}…"

Response

The created script.

A call script agents read while dialing. Ids are BIGINTs serialized as strings.

id
string

Script ID.

Example:

"17"

name
string

Display name.

Maximum string length: 255
Example:

"Summer promo pitch"

body
string

Script content; supports {{merge}} fields resolved by the agent's phone at call time.

Example:

"Hi {{first_name}}, this is {{agent_name}} from CloudTalk…"

is_archived
boolean

Whether the script is archived (soft-deleted).

Example:

false

created_at
string<date-time>

When the script was created (ISO 8601, UTC).

Example:

"2026-07-01T09:00:00.000Z"

updated_at
string<date-time>

When the script last changed (ISO 8601, UTC).

Example:

"2026-08-04T11:40:00.000Z"