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

## Returns

Returns a [Phone Connection](/concepts/product/phone-connection) 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

<ResponseField name="product_id" type="string" required>
  ID of the product this connection belongs to.
</ResponseField>

<ResponseField name="name" type="string" required>
  Name of the phone connection. Must be unique per product.
</ResponseField>

<ResponseField name="phone_number" type="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`).
</ResponseField>

<ResponseField name="agent_speaks_first" type="boolean" optional>
  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.
</ResponseField>

<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](/concepts/product/phone-connection#how-the-caller-s-language-is-chosen).
</Note>