***

title: dial
slug: /reference/typescript/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.

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

## **Response Example**

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

## **Example**

```typescript {9}
import { RestClient } from "@signalwire/sdk";

const client = new RestClient({
  project: "your-project-id",
  token: "your-api-token",
  host: "your-space.signalwire.com"
});

const result = await client.calling.dial({
  from: "+15551234567",
  to: "+15559876543",
  url: "https://example.com/call-handler",
});
console.log(result); // { id: "call-id-xxx", ... }
```