> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Phone Connection

> Create a new phone connection for a product.

> [!WARNING]
>
> You are reading the docs of Galtea 5.10. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/phone-connection/create.md).

## Returns

Returns a [Phone Connection](https://docs.galtea.ai/v5.10/concepts/product/phone-connection.md) object for the given parameters, or `None` if an error occurs.

## Example

```python theme={"system"}
phone_connection = galtea.phone_connections.create(
    product_id=product_id,
    name="production-voice-agent-" + run_identifier,
    phone_number="+14155552671",
    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](https://en.wikipedia.org/wiki/E.164) (a leading `+` followed by country code and number, e.g., `+14155552671`).

**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.

> [!NOTE]
>
> The simulated caller's spoken language is taken from each test case's language, not the phone connection, so one connection can serve test cases in different languages. See [Phone Connection](https://docs.galtea.ai/v5.10/concepts/product/phone-connection.md#how-the-callers-language-is-chosen).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.