Skip to main content
POST
Start a Quick AI Text conversation

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

UUID — when present, deduplicates repeat submissions. See /api-reference/idempotency.

Body

application/json
to_numbers
string[]
required

One or more destinations in E.164 format

Required array length: 1 - 20 elements

Destination in E.164 format

Pattern: ^\+[1-9]\d{1,14}$
goal
string
required

What the AI should accomplish over the thread. Drives the system prompt.

Required string length: 10 - 2000
language
string
default:en
required
Maximum string length: 10
max_messages
integer
default:5
required
Required range: 1 <= x <= 20
reply_delay_seconds
integer
default:0
required
Required range: 0 <= x <= 300
conversation_timeout_hours
integer
default:48
required
Required range: 1 <= x <= 168
first_message
string
Required string length: 1 - 1200
instructions
string
Maximum string length: 4000
contact_name
string
Maximum string length: 120

Response

Success

data
object
required