---
title: "Roam integration for LuumenAI"
url: "https://www.luumen.ai/integrations/roam/"
entity: SoftwareIntegration
category: "Communication"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Roam integration for LuumenAI

Read Roam chats and groups, post updates and change membership with approval

## What LuumenAI can do with Roam

LuumenAI connects to Roam with an API token and exposes 39 tools (22 read-only · 14 write · 3 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 39 tools (22 read-only · 14 write · 3 destructive)
- Plan: available on all plans
- Category: Communication

## About Roam with LuumenAI

Connect Roam and Luumen can read the channels, DMs, and groups your bot can see, pull chat history for an incident window, and look up who a user or group actually is. Posting a message, creating a group, or changing membership runs as a previewed step you approve first. Authentication is by API key.

## Example tools

Read-only (22 in total):

- `ROAM_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.
- `ROAM_GET_CHAT_HISTORY` — Lists messages in a chat, filtered by date range (after/before).
- `ROAM_GET_MEETING_LINK` — Get a meeting link.
- `ROAM_GET_RESOURCE_TYPES` — Returns the list of SCIM 2.0 resource types supported by Roam.
- `ROAM_GET_ROAM_SCIM_CONFIG` — Retrieve Roam's SCIM service provider configuration.
- `ROAM_GET_SCIM_SCHEMA` — Retrieves the definition of a specific SCIM 2.0 schema by its unique identifier (URN).
- `ROAM_GET_SCIM_USER` — Retrieve a single user by their Roam Person ID using SCIM 2.0 protocol.
- `ROAM_GET_TEST` — Test endpoint for API connectivity.

Write and destructive (17 in total, approval required by default):

- `ROAM_ADD_GROUP_MEMBERS` — Add one or more group members and/or admins to an existing Roam group.
- `ROAM_ADD_REACTION` — Add an emoji reaction to a message in a chat.
- `ROAM_CREATE_GROUP` — Create a group address that can be used for chat.
- `ROAM_CREATE_ROAM_SCIM_GROUP` — Create a new group in your Roam organization using SCIM 2.0.
- `ROAM_CREATE_USER` — Create a new user in Roam via SCIM 2.0 protocol for automated user provisioning.
- `ROAM_DELETE_GROUP` — Archive a group in Roam using SCIM 2.0 protocol.
- `ROAM_DELETE_USER` — Archive a user in Roam using SCIM 2.0 protocol.
- `ROAM_PATCH_GROUP` — Partially updates a group using SCIM 2.0 protocol.

## Frequently asked questions

### How does LuumenAI connect to Roam?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Roam on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 3 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Roam — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/roam/