> For the complete documentation index, see [llms.txt](https://pycai.gitbook.io/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pycai.gitbook.io/welcome/api/chat/create_room.md).

# create\_room

Creating a room with multiple characters

```python
client.chat.rate('CHAR', RATE)
```

{% tabs %}
{% tab title="Sync" %}

```python
from characterai import PyCAI

client = PyCAI('TOKEN')

characters = [
    {'value': 'CHAR'},
    {'value': 'CHAR'}
]

chat = client.chat.create_room(
    characters, 'NAME'
)

print(chat)
```

{% endtab %}

{% tab title="Async" %}

```python
import asyncio
from characterai import PyAsyncCAI

async def main():
    client = PyAsyncCAI('TOKEN')
    
    characters = [
        {'value': 'CHAR'},
        {'value': 'CHAR'}
    ]

    chat = await client.chat.create_room(
        characters, 'NAME'
    )
    
    print(chat)

asyncio.run(main())
```

{% endtab %}
{% endtabs %}

### name <mark style="color:green;">\[str]</mark>

Examples: Lincoln-Einstein, Music Lovers, Sci-Fi discuss

### characters <mark style="color:green;">\[str]</mark>

Please enter the names or ids of the characters you want to add to this room. Note: Only the top 5000 public characters are available for now

### topic <mark style="color:green;">\[str]</mark>

What should happen in this room. Characters will try to follow it. Examples: Play by play superhero battle, Discuss the latest episode of Game of Thrones

### token <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

You can set a specific token for the function, it will be executed from the specified token