---
title: "Plain integration for LuumenAI"
url: "https://www.luumen.ai/integrations/plain/"
entity: SoftwareIntegration
category: "ITSM & ticketing"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Plain integration for LuumenAI

Read Plain threads and customers, then reply or update records with approval.

## What LuumenAI can do with Plain

LuumenAI connects to Plain with an API token and exposes 22 tools (11 read-only · 8 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: 22 tools (11 read-only · 8 write · 3 destructive)
- Plan: available on all plans
- Category: ITSM & ticketing

## About Plain with LuumenAI

Connect Plain and your agent can read support threads, customers, companies, tiers, and linked issue tracker records without leaving the terminal. It can trace a thread back to the customer and their tier before you decide anything. Changes — sending a message, updating a thread, upserting a customer — are previewed and held for your approval by default. Luumen authenticates with an API key.

## Example tools

Read-only (11 in total):

- `PLAIN_FETCH_COMPANY` — Fetch company details by ID.
- `PLAIN_FETCH_ISSUES` — Fetches external issue tracker links (Jira, Linear, GitHub, etc.) associated with a customer's threads.
- `PLAIN_FETCH_TIER` — Fetch a tier by its ID.
- `PLAIN_GET_CUSTOMER_BY_EMAIL` — Fetch customer details by email address.
- `PLAIN_GET_CUSTOMER_BY_ID` — Retrieve details of a specific customer by their unique ID.
- `PLAIN_GET_CUSTOMERS` — Fetch a list of customers.
- `PLAIN_GET_THREAD_BY_ID` — Fetches comprehensive details of a specific thread by ID, including customer info, status, priority, labels, and assignments.
- `PLAIN_GET_USER_BY_ID` — Fetch workspace user/team member by ID.

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

- `PLAIN_ADD_CUSTOMER_TO_GROUP` — Add a customer to one or more customer groups.
- `PLAIN_CREATE_CUSTOMER_GROUP` — Creates a new customer group in Plain for organizing and segmenting customers.
- `PLAIN_CREATE_THREAD` — Create a new thread.
- `PLAIN_DELETE_CUSTOMER` — Delete a customer from the system.
- `PLAIN_DELETE_USER` — Delete a user from the system.
- `PLAIN_REMOVE_CUSTOMER_FROM_GROUP` — Removes a customer from one or more customer groups in Plain.
- `PLAIN_RUN_GRAPHQL_QUERY` — Execute any GraphQL query or mutation against Plain API.
- `PLAIN_SEND_MESSAGE` — Send a new message within a thread.

## Frequently asked questions

### How does LuumenAI connect to Plain?

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

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