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

# Superchat integration for LuumenAI

Read Superchat conversations and contacts, then change them as approved steps

## What LuumenAI can do with Superchat

LuumenAI connects to Superchat with an API token and exposes 17 tools (12 read-only · 4 write · 1 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: 17 tools (12 read-only · 4 write · 1 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Communication

## About Superchat with LuumenAI

Superchat holds the customer conversations your team runs across WhatsApp, Instagram, Messenger, and email. Connect it with an API key and Luumen can read channels, inboxes, contacts, labels, templates, and webhooks for context. Changes — a new contact, an updated record, a rerouted webhook — are previewed and held for your approval by default.

## Example tools

Read-only (12 in total):

- `SUPERCHAT_GET_CONTACT` — Retrieve a specific contact's details by ID.
- `SUPERCHAT_GET_FILE` — Retrieve metadata for a specific file by its ID.
- `SUPERCHAT_GET_USER` — Retrieve details of a specific user in the Superchat workspace by their user ID.
- `SUPERCHAT_LIST_CHANNELS` — Lists all communication channels in your Superchat workspace.
- `SUPERCHAT_LIST_CONTACTS` — List all contacts in the Superchat workspace with cursor-based pagination.
- `SUPERCHAT_LIST_CONVERSATIONS` — Retrieves a paginated list of all conversations in your Superchat account.
- `SUPERCHAT_LIST_CUSTOM_ATTRIBUTES` — List all custom attributes defined for contacts in your Superchat account.
- `SUPERCHAT_LIST_INBOXES` — List all inboxes.

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

- `SUPERCHAT_CREATE_CONTACT` — Create a new contact in Superchat with phone or email handles.
- `SUPERCHAT_CREATE_TEMPLATE_FOLDER` — Create a new template folder in SuperChat for organizing message templates.
- `SUPERCHAT_DELETE_WEBHOOK` — Delete a specific webhook by its ID.
- `SUPERCHAT_UPDATE_CONTACT` — Update information for a specific contact in Superchat.
- `SUPERCHAT_UPDATE_WEBHOOK` — Update an existing webhook's target URL and/or event subscriptions.

## Frequently asked questions

### How does LuumenAI connect to Superchat?

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

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