> For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

# join_room

> Join a RELAY Room Session.

Join a RELAY room. If the room doesn't exist, it creates a new room.

An object that accepts the following properties.

## **Properties**

Name of the room to join. Allowed characters: `A-Z | a-z | 0-9_-`

You can create a room via out REST API [here](/docs/apis/rest/video/rooms/create-room)

## **Variables**

Set by the method:

* **join\_room\_result:** (out) `joined` | `failed`

## **Examples**

### Joining a room

```yaml
version: 1.0.0
sections:
  main:
    - join_room:
        name: my_room
```

```json
{
  "version": "1.0.0",
  "sections": {
    "main": [
      {
        "join_room": {
          "name": "my_room"
        }
      }
    ]
  }
}
```