Skip to main content
POST
Create phone connection
You are reading the docs of Galtea 5.17. Read this page in the latest version.

Authorizations

Authorization
string
header
required

API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....

Body

application/json
productId
string
required
Example:

"prod_123"

name
string
required
Example:

"Support line"

phoneNumber
string
required

The phone number Galtea dials, in E.164 format.

Example:

"+14155552671"

id
string
Example:

"phoneConnection_123"

userId
string | null
Example:

"user_123"

agentSpeaksFirst
boolean
default:false

Whether the voice agent opens the conversation once the call connects. false (default) means the simulated caller speaks first; true suits interviewer-style agents that greet first.

Example:

false

createdAt
string<date-time>
deletedAt
string<date-time> | null

Response

Phone connection created successfully

productId
string
required
Example:

"prod_123"

name
string
required
Example:

"Support line"

phoneNumber
string
required

The phone number Galtea dials, in E.164 format.

Example:

"+14155552671"

id
string
Example:

"phoneConnection_123"

userId
string | null
Example:

"user_123"

agentSpeaksFirst
boolean
default:false

Whether the voice agent opens the conversation once the call connects. false (default) means the simulated caller speaks first; true suits interviewer-style agents that greet first.

Example:

false

createdAt
string<date-time>
deletedAt
string<date-time> | null