***

title: dial
slug: /reference/python/rest/calling/dial
description: Initiate a new outbound call via REST.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

Initiate a new outbound call. Provide either a `url` pointing to a SWML document
or an inline `swml` object to control the call flow.

<Note>
  Since `from` is a Python reserved keyword, pass it as `from_=` or use dict
  unpacking: `**{"from": "+15551234567"}`.
</Note>

<EndpointSchemaSnippet endpoint="POST /api/calling/calls" />

## **Response Example**

<EndpointResponseSnippet endpoint="POST /api/calling/calls" />

## **Example**

```python {9}
from signalwire.rest import RestClient

client = RestClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
)

result = client.calling.dial(
    from_="+15551234567",
    to="+15559876543",
    url="https://example.com/call-handler",
)
print(result)  # {"id": "call-id-xxx", ...}
```