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

# Outbound SIP calls

> Start a call through an assigned Voiceflow or bring-your-own SIP connection.

## Place an outbound call

Start a call through an assigned Voiceflow or bring-your-own SIP connection.

#### Place an outbound SIP call

Dial through an assigned SIP connection after configuration, API-key, credit and production-concurrency checks. Success means the dial request was accepted; it does not confirm that the destination answered. This operation returns no call ID or JSON payload.

##### Endpoint

```http
POST /v1/sip-connection/{sipConnectionID}/outbound
```

Server: https://runtime-api.voiceflow.com

##### Authentication

```json
[
  {
    "ApiKeyAuth": []
  }
]
```

`ApiKeyAuth`:

```json
{
  "type": "apiKey",
  "in": "header",
  "name": "Authorization",
  "description": "A Voiceflow API key authorized for project:READ and project.versions:READ on the connection's assigned agent. Keep the key server-side. SIP digest credentials and Socket.IO session keys do not authorize this request."
}
```

##### Path parameters

###### `sipConnectionID`

Required · string

The connection ID shown by Outbound call API in Creator. This is not the connection's SIP hostname or an agent ID.

```json
{
  "type": "string"
}
```

##### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "to"
        ],
        "properties": {
          "to": {
            "type": "string",
            "minLength": 1,
            "description": "A valid phone number in E.164 format. Bring your own SIP also accepts a digits-only PBX extension of 1–15 digits; Voiceflow SIP does not. Arbitrary SIP URIs are not accepted here.",
            "example": "+14165550123"
          }
        }
      }
    }
  }
}
```

##### Responses

###### 200

Dial request accepted. Empty response body.

###### 400

Invalid destination; connection not assigned; outbound settings incomplete; or connection not ready for outbound calls. Check the destination and saved connection settings before retrying.

###### 402

Workspace credit limit reached.

###### 404

SIP connection not found.

###### 429

Production concurrency limit reached. Wait for capacity before retrying.

##### Request examples

###### cURL

```bash
curl --request POST \
  --url 'https://runtime-api.voiceflow.com/v1/sip-connection/<sipConnectionID>/outbound' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "to": "+14165550123"
}'
```

###### JavaScript

```javascript
const response = await fetch('https://runtime-api.voiceflow.com/v1/sip-connection/<sipConnectionID>/outbound', {
  method: 'POST',
  headers: {
    Authorization: '<api-key>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "to": "+14165550123"
  }),
});
// This operation returns no response body.
console.log(response.status);
```

###### Python

```python
import requests

response = requests.post(
    'https://runtime-api.voiceflow.com/v1/sip-connection/<sipConnectionID>/outbound',
    headers={'Authorization': '<api-key>'},
    json={
      "to": "+14165550123"
    },
)
response.raise_for_status()
# This operation returns no response body.
```

## Credentials

Call from a trusted server using a Voiceflow API key authorized for `project:READ` and `project.versions:READ` on the assigned agent. Do not send the SIP username/password or a Socket.IO session key as HTTP authorization. See [API authentication](/docs/api-reference/authentication).

## Destination and connection requirements

| Connection | Accepted `to` value |
| --- | --- |
| Voiceflow SIP | A valid E.164 number such as `+14165550123`. |
| Bring your own SIP | A valid E.164 number, or a PBX extension containing 1–15 digits. |

The connection must be assigned and have outbound routing and Caller ID configured. `to` does not accept an arbitrary SIP URI. The operation has no request fields for variables, custom headers, Environment overrides, batch calling or a client-supplied idempotency key.

## Interpret the result

HTTP `200` has an empty body. It confirms the dial request was accepted, not that the destination answered, that a transfer succeeded, or that a conversation completed. No call ID is returned.

An ambiguous timeout can occur after a dial was accepted. Check your provider’s call records before retrying; an automatic retry can place another call.

## Test the configured connection

In Creator, open **Phone numbers → Outbound call API → View** for the configured connection. Copy the connection-specific URL, or use **Test call → Call** with a destination you control. This starts a real call through the selected trunk.

The Request frame above shows the equivalent server-side call. Keep the `sipConnectionID` from the URL separate from the SIP hostname used for inbound routing.

## Recover from a failed request

The operation’s response list above covers source-defined `400`, `402`, `404` and `429` conditions. Resolve authentication failures by checking the API key and assigned-project permissions. For a `400`, distinguish invalid destination, missing assignment, incomplete outbound settings and connection provisioning before retrying. See [SIP troubleshooting](/docs/api-reference/agent-runtime/voice/sip/troubleshooting).
