# Common Room

> Read Common Room community intelligence - members, activities, segments - and add notes and tags via the Community API.

Lets an agent work with your Common Room community intelligence through the Community API: list and search members, get a member, list activities and segments, list tags, and write notes or apply tags to a member. Useful for community CRM enrichment from a workflow.

## What it can do

| Method | What it does |
| --- | --- |
| `commonroom_members_list` | List community members (optionally by segment). |
| `commonroom_members_search` | Search members by free text (name / email / handle). |
| `commonroom_member_get` | Get one member by ID. |
| `commonroom_activities_list` | List activities (optionally for one member). |
| `commonroom_segments_list` | List segments. |
| `commonroom_tags_list` | List tags. |
| `commonroom_note_create` | Create a note on a member. |
| `commonroom_tag_add` | Apply a tag to a member. |
| `commonroom_request` | Generic passthrough to any Community API endpoint for full API coverage. |

## How to get your token

Common Room authenticates with an **API token** sent as the `Authorization: Bearer <token>` header.

1. Sign in to Common Room.
2. Open **Settings -> API tokens** (see the [Common Room docs](https://www.commonroom.io/docs/)).
3. Create a token and copy it.
4. Paste it into FlyMyAI.

## Fields to fill

| FlyMyAI field | Where it comes from |
| --- | --- |
| `COMMONROOM_API_TOKEN` | Common Room -> Settings -> API tokens |

## Troubleshooting

- **`401 Unauthorized`** - the token is wrong or revoked. Create a new one under Settings -> API tokens.
- **`403 Forbidden`** - the token's plan or role does not grant API access; check your Common Room plan and token permissions.
- **`404 Not Found` on a named action** - the exact path for that resource differs on your account. Use `commonroom_request` with the path from your account's API docs.
- **Empty member results** - the segment ID filter may be wrong; list segments first with `commonroom_segments_list`.

## Links

- [Common Room documentation](https://www.commonroom.io/docs/)
- [Community API reference](https://api.commonroom.io/docs/community.html)