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

# conversation.joined

GET /

Receive conversation.joined events

Reference: https://signalwire.com/docs/apis/relay/client/fabric/conversation-joined

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: conversation.joined
  version: subpackage_conversationJoined.conversation.joined
  description: Receive conversation.joined events
channels:
  /:
    description: Receive conversation.joined events
    publish:
      operationId: subpackage_conversationJoined.conversation.joined-publish
      summary: conversation.joined
      message:
        name: onConversationJoinedConversationJoinedEvent
        title: conversation.joined
        payload:
          $ref: '#/components/schemas/conversation.joined_conversationJoinedEvent'
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsConversationJoinedMessagesConversationJoinedEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsConversationJoinedMessagesConversationJoinedEventJsonrpc
    ChannelsConversationJoinedMessagesConversationJoinedEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsConversationJoinedMessagesConversationJoinedEventMethod
    ChannelsConversationJoinedMessagesConversationJoinedEventParamsEventType:
      type: string
      enum:
        - conversation.joined
      description: The event type — identifies which event this is.
      title: ChannelsConversationJoinedMessagesConversationJoinedEventParamsEventType
    Fabric.ConversationJoinedParams:
      type: object
      properties:
        fabric_subscriber_id:
          type: string
          description: The subscriber that joined the conversation.
        from_fabric_address_id:
          type: string
          description: The Resource address the subscriber joined from.
        group_id:
          type: string
          description: Identifier of the conversation group that was joined.
        conversation_name:
          type: string
          description: Human-readable name of the conversation.
      required:
        - fabric_subscriber_id
        - from_fabric_address_id
        - group_id
        - conversation_name
      description: >-
        Payload of the `conversation.joined` event: the subscriber and
        conversation joined.
      title: Fabric.ConversationJoinedParams
    ChannelsConversationJoinedMessagesConversationJoinedEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsConversationJoinedMessagesConversationJoinedEventParamsEventType
          description: The event type — identifies which event this is.
        event_channel:
          type: string
          description: The subscriber's Conversation stream this event was delivered on.
        timestamp:
          type: string
          description: >-
            When the event was emitted, as a string-encoded epoch timestamp. The
            unit

            differs by event: `conversation.message` and `conversation.joined`
            send

            fractional seconds (e.g. `"1712345678.842113"`);
            `conversation.message.updated`

            and `conversation.broadcast` send milliseconds (e.g.
            `"1712345678842"`).
        is_author:
          type: boolean
          description: Whether the receiving subscriber authored this message.
        params:
          $ref: '#/components/schemas/Fabric.ConversationJoinedParams'
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - is_author
        - params
      description: The event envelope.
      title: ChannelsConversationJoinedMessagesConversationJoinedEventParams
    conversation.joined_conversationJoinedEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsConversationJoinedMessagesConversationJoinedEventJsonrpc
          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/ChannelsConversationJoinedMessagesConversationJoinedEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsConversationJoinedMessagesConversationJoinedEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Fires when a subscriber is added to a conversation. `params` identifies
        the subscriber, the

        originating address, and the conversation group and name. The envelope
        `timestamp` is a

        string of Unix seconds with a fractional part, for example
        `"1712345678.842"`.
      title: conversation.joined_conversationJoinedEvent

```