---
title: "Modem integration for LuumenAI"
url: "https://www.luumen.ai/integrations/modem/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Modem integration for LuumenAI

Read customer topics, people, and company records — change them with approval

## What LuumenAI can do with Modem

LuumenAI connects to Modem with an API token and exposes 30 tools (19 read-only · 8 write · 3 destructive). 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: 30 tools (19 read-only · 8 write · 3 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Databases & data platforms

## About Modem with LuumenAI

Connect Modem and your agent can read the structured side of your customer conversations: topic summaries and lifecycle, person profiles and identities, company activity and merge history. When something needs correcting — a topic priority, a stale company record, two duplicate people — the agent proposes the change and waits for your approval before writing. Authentication is by API key.

## Example tools

Read-only (19 in total):

- `MODEM_GET_CHANNEL` — Get one channel's source details, connection state, context, timestamps, and message count by UUID.
- `MODEM_GET_COMPANY` — Get one company's core details, connection values, domain, logo, and VIP status by decimal ID.
- `MODEM_GET_COMPANY_ACTIVITY` — Get one company's message count, weekly activity series, and source-level message breakdown.
- `MODEM_GET_COMPANY_HISTORY` — Get up to 50 company audit records plus merge history.
- `MODEM_GET_COMPANY_IDENTITIES` — Get external platform identities linked to one company by Modem's identify operation.
- `MODEM_GET_CURRENT_ORGANIZATION` — Return the organization selected by the connected API key.
- `MODEM_GET_PERSON` — Get one person's complete profile, including company, connections, tags, sources, timestamps, identities, and message activity aggregates.
- `MODEM_GET_PERSON_HISTORY` — Get up to 50 person audit records plus merge history.

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

- `MODEM_ADD_PEOPLE_TO_COMPANY` — Associate one or more existing people with an existing company.
- `MODEM_CREATE_COMPANIES` — Create one to 50 companies in one batch.
- `MODEM_CREATE_PEOPLE` — Create one to 50 people in one batch.
- `MODEM_IDENTIFY_EXTERNAL_RECORDS` — Upsert links from external platform records to Modem people and companies in batches of 50.
- `MODEM_MERGE_COMPANIES` — Irreversibly merge one or more source companies into one surviving target.
- `MODEM_MERGE_PEOPLE` — Irreversibly merge one or more source people into one surviving target.
- `MODEM_MERGE_TOPICS` — Irreversibly merge 1 to 50 source topics into one surviving target.
- `MODEM_UPDATE_COMPANIES` — Update one to 50 companies in one batch.

## Frequently asked questions

### How does LuumenAI connect to Modem?

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 Modem 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 Modem — read or write, approved or declined — is recorded with the actor, the input, and the result.

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