> This page is for APIs.

> 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.

# call.connect

GET /

Receive call.connect events

Reference: https://signalwire.com/docs/apis/relay/client/fabric/call-connect

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: call.connect
  version: subpackage_callConnect.call.connect
  description: Receive call.connect events
channels:
  /:
    description: Receive call.connect events
    publish:
      operationId: subpackage_callConnect.call.connect-publish
      summary: call.connect
      message:
        name: onCallConnectCallConnectEvent
        title: call.connect
        payload:
          $ref: '#/components/schemas/call.connect_callConnectEvent'
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsCallConnectMessagesCallConnectEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallConnectMessagesCallConnectEventJsonrpc
    ChannelsCallConnectMessagesCallConnectEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsCallConnectMessagesCallConnectEventMethod
    ChannelsCallConnectMessagesCallConnectEventParamsEventType:
      type: string
      enum:
        - call.connect
      description: The event type — identifies which event this is.
      title: ChannelsCallConnectMessagesCallConnectEventParamsEventType
    Fabric.FabricCallDevice:
      type: object
      properties:
        type:
          type: string
          description: The device type, such as `phone`, `sip`, or `webrtc`.
        params:
          type: object
          additionalProperties:
            description: Any type
          description: Device-specific parameters.
      required:
        - type
      description: The device handling a Call Fabric call leg.
      title: Fabric.FabricCallDevice
    Fabric.FabricConnectPeer:
      type: object
      properties:
        node_id:
          type: string
          description: The node the peer call leg lives on.
        call_id:
          type: string
          description: The peer call's `call_id`.
        tag:
          type: string
          description: The `tag` set on the peer call.
        queue_id:
          type: string
          description: When the peer was reached through a queue, the queue's id.
        queue_name:
          type: string
          description: Human-readable name of the queue the peer was reached through.
        device:
          $ref: '#/components/schemas/Fabric.FabricCallDevice'
          description: The device handling the peer call.
      description: The other call being connected to yours.
      title: Fabric.FabricConnectPeer
    FabricCallConnectParamsConnectState:
      type: string
      enum:
        - disconnected
        - connecting
        - connected
        - failed
      description: >-
        Where the connection stands: `connecting`, `connected`, `disconnected`,
        or `failed`.
      title: FabricCallConnectParamsConnectState
    Fabric.CallConnectParams:
      type: object
      properties:
        call_id:
          type: string
          description: >-
            Unique identifier of the call this event is about. Always present on
            Fabric events.
        node_id:
          type: string
          description: The node the call leg lives on.
        room_session_id:
          type: string
          description: >-
            The room session this call leg belongs to. In a 1:1 call this equals
            the `call_id`.
        segment_id:
          type: string
          description: >-
            Identifier of the call segment this event belongs to, for
            correlating events within the same segment.
        tag:
          type: string
          description: >-
            The `tag` the leg was dialed with, when a server-side application
            set one on the dial. Absent otherwise.
        peer:
          $ref: '#/components/schemas/Fabric.FabricConnectPeer'
          description: The other call yours is being connected to.
        connect_state:
          $ref: '#/components/schemas/FabricCallConnectParamsConnectState'
          description: >-
            Where the connection stands: `connecting`, `connected`,
            `disconnected`, or `failed`.
        failed_reason:
          type: string
          description: Why the connect failed. Present when `connect_state` is `failed`.
      required:
        - call_id
        - node_id
        - room_session_id
        - connect_state
      description: >-
        Payload of the Call Fabric `call.connect` event: how a connect request
        to a peer is progressing.
      title: Fabric.CallConnectParams
    ChannelsCallConnectMessagesCallConnectEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsCallConnectMessagesCallConnectEventParamsEventType
          description: The event type — identifies which event this is.
        event_channel:
          type: string
          description: >-
            The channel the event was delivered on — for Calling events, the
            `protocol`

            string your connection received from `signalwire.connect`.
        timestamp:
          type: number
          format: double
          description: >-
            When the event was emitted, as a Unix timestamp in seconds. Always
            present.
        project_id:
          type: string
          description: >-
            Your project ID. Present on Calling events and most Call Fabric
            events; absent on `call.joined`, `call.left`, `member.joined`, and
            `member.left`.
        space_id:
          type: string
          description: >-
            Your space ID. Present on Calling events and most Call Fabric
            events; absent on `call.joined`, `call.left`, `member.joined`, and
            `member.left`.
        params:
          $ref: '#/components/schemas/Fabric.CallConnectParams'
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - params
      description: The event envelope.
      title: ChannelsCallConnectMessagesCallConnectEventParams
    call.connect_callConnectEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsCallConnectMessagesCallConnectEventJsonrpc
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: >-
            Event id — a unique UUID generated for each event. Events are
            notifications: you do not reply to them.
        method:
          $ref: >-
            #/components/schemas/ChannelsCallConnectMessagesCallConnectEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsCallConnectMessagesCallConnectEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Fires as a connect progresses, telling you whether your Call Fabric call
        has been bridged to the peer. Watch `connect_state` to know when the two
        calls are joined, torn down, or have failed to connect. SWML or a
        server-side application starts the connect; there is no client request
        that starts it.
      title: call.connect_callConnectEvent

```