> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# CallCreateError

> Thrown when a call cannot be created.

Raised by [`SignalWire.dial`](/docs/browser-sdk/v4/reference/signalwire#dial) and the inbound-call flow when a call cannot be brought to the `connecting` state — typical causes are signaling-layer failure, authentication rejection, or the server refusing the call invite. The `direction` property distinguishes whether the failure occurred while placing an outbound call or accepting an inbound one.

## **Extends**

* `Error`

## **Constructors**

### Constructor

```ts
new CallCreateError(message, error?, direction?, options?): CallCreateError
```

### Parameters

**`message`** `string` — required

Human-readable error message.

---

**`error`** `unknown`

Underlying error that caused the call creation to fail, if any.

---

**`direction`** `'inbound' | 'outbound'`

Direction of the call that failed to create.

---

**`options`** `ErrorOptions`

Standard `ErrorOptions` (e.g. `cause`).

---

## **Properties**

**`direction`** `'inbound' | 'outbound'` — required

Direction of the call that failed to create.

---

**`error`** `unknown` — required

Underlying error that caused the call creation to fail, if any.

---

**`message`** `string` — required

Human-readable error message.

---

## **Examples**

```ts
import { CallCreateError } from '@signalwire/js';

try {
  const call = await client.dial('/public/my-room', { audio: true, video: true });
} catch (err) {
  if (err instanceof CallCreateError) {
    console.error(`Failed to create ${err.direction} call:`, err.message, err.error);
  }
}
```

> Thrown when a call cannot be created.