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

# Heartbeat integration for LuumenAI

Read your Heartbeat community roster, and restore removed members on approval.

## What LuumenAI can do with Heartbeat

LuumenAI connects to Heartbeat with an API token and exposes 7 tools (6 read-only · 1 write). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 7 tools (6 read-only · 1 write)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Communication

## About Heartbeat with LuumenAI

Connect Heartbeat and Luumen can answer questions about your community without you opening the admin panel: who the members are, which channels exist, what access groups they belong to, and what events are on the calendar. When someone who was removed needs back in, the agent looks up the account first, shows you what it plans to do, and reactivates it once you approve. Authentication is by API key.

## Example tools

Read-only (6 in total):

- `HEARTBEAT_GET_EVENTS` — Retrieve event information from the community.
- `HEARTBEAT_LIST_CHANNELS` — Retrieve a paginated list of channels in the community.
- `HEARTBEAT_LIST_GROUPS` — Retrieve a paginated list of access groups in the community.
- `HEARTBEAT_LIST_USERS` — Retrieve a paginated list of users in the Heartbeat community.
- `HEARTBEAT_RETRIEVE_GROUP` — Retrieve a single group by its ID.
- `HEARTBEAT_RETRIEVE_USER` — Retrieve a single user by their ID.

Write and destructive (1 in total, subject to configured approval policy):

- `HEARTBEAT_REACTIVATE_USER` — Reactivate a previously deleted user by email to allow them to access the community again.

## Frequently asked questions

### How does LuumenAI connect to Heartbeat?

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 Heartbeat on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

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

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