***

title: join_room
slug: /reference/python/relay/call/join-room
description: Join a video/audio room.
max-toc-depth: 3
---------------------

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

[leave-room]: /docs/server-sdks/reference/python/relay/call/leave-room

Join a video/audio room. Rooms provide multi-party communication with
additional features beyond conferences, including video support.

<Info>
  Use [`leave_room()`][leave-room] to leave the room.
</Info>

## **Parameters**

<ParamField path="name" type="str" required={true} toc={true}>
  Room name to join.
</ParamField>

<ParamField path="status_url" type="Optional[str]" toc={true}>
  URL to receive room status webhooks.
</ParamField>

## **Returns**

`dict` -- Server response confirming the join.

## **Example**

```python {15}
from signalwire.relay import RelayClient

client = RelayClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
    contexts=["default"],
)

@client.on_call
async def handle_call(call):
    await call.answer()

    # Join a room
    await call.join_room("meeting-room-1")

    # The call is now in the room until leave_room() or hangup

client.run()
```