Place a call, or launch a campaign

POST

/voice/v1/deliver

Last modified:2026-09-08 16:31:57

One recipient is dialled within seconds and returns the call id. Two or more create a campaign and return the campaign id.

Validation happens before anything is stored, so a rejected request costs nothing and places no calls.

Request

Authorization

API Key

Add parameter in header

X-API-KEY

Example:

X-API-KEY: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Accepted and stored. The shape depends on the number of recipients — a single call returns the id as a bare JSON string, a campaign returns an object. This asymmetry is a known wart and will be unified in a future version, with notice.

Bodyapplication/json

🟠400

🟠401

🟠403

🔴500

🔴502

Request Example

Shell

JavaScript

Java

Swift

cURL

One call, read aloudOne call with your own recordingA scheduled campaignA campaign with a recording

curl --location 'https://api.trucontact.co/voice/v1/deliver' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "recipients": [
        "+573156991939"
    ],
    "messageBody": "Hello Ingrid. Your appointment is confirmed for Thursday at ten."
}'

Response Example

200 - One recipient — the call id

6a97202eae1ea0a03dfb7d16

Modified at 2026-09-08 16:31:57

SendSmsBatch

Health check