Skip to main content

​
Returns

Returns a Phone Connection object for the given parameters, or None if an error occurs.

​
Example

phone_connection = galtea.phone_connections.create(
    product_id=product_id,
    name="production-voice-agent-" + run_identifier,
    phone_number="+14155552671",
    voice="sarah",  # en-GB female; omit to use the default
    language_code="en",
    agent_speaks_first=False,
)

​
Parameters

​
product_id
string
required
ID of the product this connection belongs to.
​
name
string
required
Name of the phone connection. Must be unique per product.
​
phone_number
string
required
The phone number Galtea dials to reach your AI agent, in E.164 format (a leading + followed by country code and number, e.g., +14155552671).
​
voice
string
TTS voice the simulated caller speaks with (Speechmatics, English-only). Supported values: sarah (en-GB female), theo (en-GB male), megan (en-US female), jack (en-US male). Leave as None to use the default voice (sarah). An unsupported value is rejected with HTTP 400. Use list_voices() to retrieve the current catalog.
​
language_code
string
Language code for the call (e.g., en, es).
​
agent_speaks_first
boolean
Whether the voice agent opens the conversation once the call connects. Defaults to False (the simulated caller speaks first). Pass True for interviewer-style agents that greet the caller first.