For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inSign up
Support
GuidesReferenceClick-to-Call
GuidesReferenceClick-to-Call
  • Core
    • Overview
  • Entities
    • SignalWire
    • Address
    • Participant
    • ClientPreferences
    • SelfCapabilities
    • SelfParticipant
    • User
    • WebRTCCall
      • CallCreateError
      • CollectionFetchError
      • DeviceTokenError
      • DPoPInitError
      • InvalidCredentialsError
      • MediaTrackError
      • MessageParseError
      • OverconstrainedFallbackError
      • PreflightError
      • RecoveryError
      • TokenRefreshError
      • UnexpectedError
      • VertoPongError
  • Web Components
    • Overview
    • sw-audio-level
    • sw-call-controls
    • sw-call-dialpad
    • sw-call-media
    • sw-call-provider
    • sw-call-status
    • sw-call-widget
    • sw-click-to-call
    • sw-device-selector
    • sw-directory
    • sw-local-camera
    • sw-participant-controls
    • sw-participants
    • sw-self-media
    • sw-ui-alert
    • sw-ui-background
    • sw-ui-call-layout
    • sw-ui-content-drawer
    • sw-ui-control-bar
    • sw-ui-dialpad
    • sw-ui-dropup
    • sw-ui-icon
    • sw-ui-modal
    • sw-ui-responsive-container
    • sw-ui-split-button
    • sw-ui-transcript-view
LogoLogoSignalWire Docs
Log inSign up
Support
On this page
  • Extends
  • Constructors
  • Constructor
  • Parameters
  • Properties
  • Examples
EntitiesErrors

CallCreateError

|View as Markdown|Open in Claude|
Was this page helpful?
Edit this page
Previous

CollectionFetchError

Next
Built with

Raised by 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

1new CallCreateError(message, error?, direction?, options?): CallCreateError

Parameters

message
stringRequired

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
unknownRequired

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

message
stringRequired

Human-readable error message.

Examples

1import { CallCreateError } from '@signalwire/js';
2
3try {
4 const call = await client.dial('/public/my-room', { audio: true, video: true });
5} catch (err) {
6 if (err instanceof CallCreateError) {
7 console.error(`Failed to create ${err.direction} call:`, err.message, err.error);
8 }
9}