# Roam AI integration on Definable

> Roam HQ provides APIs for secure messaging, chat, file sharing, and collaboration with enterprise-grade security and compliance features.

## What this connects

Roam HQ provides APIs for secure messaging, chat, file sharing, and collaboration with enterprise-grade security and compliance features.

Vendor: https://ro.am

## Tools available

**39** tools available. First 12:

- `ROAM_ADD_GROUP_MEMBERS` — Add group members — Add one or more group members and/or admins to an existing Roam group. Use this tool when: - You need to add new members to an existing group - You need to promote existing members to admin status - You want to bulk add multiple users to a group Access conditions: - For adding members: The group must be public in the user's Roam, or the app must be a member - For adding admins: The app must be an admin of the group Returns empty response on success (HTTP 204).
- `ROAM_ADD_REACTION` — Add Reaction to Message — Add an emoji reaction to a message in a chat. Use this action when you want to react to a message with an emoji in a Roam chat. The action requires the message ID, chat ID, reaction name, and timestamp. Required scope: chat:send_message or chat:write Response codes: 200=success, 400=bad request, 401=invalid credentials, 405=unsupported method, 500=internal error
- `ROAM_CREATE_GROUP` — Create Group — Create a group address that can be used for chat. Groups which specify an admin will operate in an "Admin only" management mode, where only admins may change settings. Otherwise, all members have that capability. Groups require at least one member or admin.
- `ROAM_CREATE_ROAM_SCIM_GROUP` — Create Roam SCIM Group — Tool to create a new group in your Roam organization using SCIM 2.0. Use when you need to provision a new group for managing user access and permissions via the SCIM 2.0 protocol. The displayName is required and must be 64 characters or less.
- `ROAM_CREATE_USER` — Create Roam User — Create a new user in Roam via SCIM 2.0 protocol for automated user provisioning. Use when you need to add a new user to your Roam organization. The userName must match the primary email address exactly. The role defaults to 'User' but can be set to 'Admin' for administrative access. Note: Password attributes are not supported and will be ignored.
- `ROAM_DELETE_GROUP` — Delete Roam Group — Archive a group in Roam using SCIM 2.0 protocol. This is a soft delete operation that archives the group. Use when you need to archive a group that is no longer needed while preserving data for audit purposes. Returns 204 No Content on successful deletion.
- `ROAM_DELETE_USER` — Delete Roam User — Archive a user in Roam using SCIM 2.0 protocol. This is a soft delete operation that deprovisions the user. Use when you need to remove a user from the organization while preserving their data for audit purposes. Returns 204 No Content on successful deletion.
- `ROAM_GET_ADDRESS_INFO` — Get Address Info — Get information about a chat address, which is the name for any entity that may participate in a chat, such as a user, visitor, or bot. Use this action to retrieve details like display name, email, profile image, and other information about a specific chat address. Required scope: chat:read
- `ROAM_GET_CHAT_HISTORY` — Get chat history — Lists messages in a chat, filtered by date range (after/before). The ordering of results depends on the filter specified: - If no parameters provided: returns most recent messages, sorted in reverse chronological order. - If 'after' is specified: results sorted in forward chronological order. In Personal mode, only chats where the authenticated user is a participant are accessible. Use this action to retrieve message history from a specific chat.
- `ROAM_GET_MEETING_LINK` — Get meeting link — Tool to get a meeting link. Use when you need to retrieve information about a specific meeting link by its ID. Requires the 'meetinglink:read' scope.
- `ROAM_GET_RESOURCE_TYPES` — Get Roam SCIM Resource Types — Returns the list of SCIM 2.0 resource types supported by Roam. Use this action to discover what resource types are available in the Roam SCIM API. Currently returns User and Group resource types. This endpoint requires no parameters.
- `ROAM_GET_ROAM_SCIM_CONFIG` — Get SCIM service provider config — Tool to retrieve Roam's SCIM service provider configuration. Use when you need to discover Roam's SCIM API capabilities including supported authentication schemes, bulk operations, filtering, and other service provider features. This endpoint returns the SCIM 2.0 ServiceProviderConfig resource which describes the supported features.

## Auth

Auth schemes: `API_KEY`, `OAUTH2`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Roam

Inside a Definable workflow, Roam is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Roam** — the Researcher (GPT-5.5) pulls context from Roam (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Roam** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Roam (create record, post message, draft email).
- **Designer / Engineer → Distributor → Roam** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Roam (attach file, open PR comment, post status).

The Verifier checks every Roam call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- communication — https://definable.ai/apps/category/communication/
- productivity — https://definable.ai/apps/category/productivity/

## Related

- HTML page: https://definable.ai/apps/roam/
- Same category (communication): https://definable.ai/apps/category/communication/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt