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

# Lettr integration for LuumenAI

Read delivery state, templates, and audiences. Change sends with approval.

## What LuumenAI can do with Lettr

LuumenAI connects to Lettr with an API token and exposes 60 tools (25 read-only · 23 write · 12 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: 60 tools (25 read-only · 23 write · 12 destructive)
- Plan: available on all plans
- Category: Communication

## About Lettr with LuumenAI

Connect Lettr and Luumen can answer questions about your sending without you opening the dashboard. Check whether a domain is verified, why a transactional message stalled, which merge tags a template needs, or how large a segment has grown. When something has to change — a scheduled campaign pulled, a list created, a contact removed — Luumen shows the exact call first and waits for your approval.

## Example tools

Read-only (25 in total):

- `LETTR_GET_AUDIENCE_CONTACT` — Retrieve one contact's email, status, custom properties, list memberships, and topic subscriptions by ID.
- `LETTR_GET_AUDIENCE_LIST` — Retrieve one audience list and its current contact count by ID.
- `LETTR_GET_AUDIENCE_PROPERTY` — Retrieve one custom contact-property definition and its fallback value.
- `LETTR_GET_AUDIENCE_SEGMENT` — Retrieve one dynamic segment's list restriction, complete AND-of-OR condition definition, and cached contact count.
- `LETTR_GET_AUDIENCE_TOPIC` — Retrieve one subscription topic's defaults, visibility, and current contact count.
- `LETTR_GET_CAMPAIGN` — Retrieve one campaign's name, subject, sender and reply-to configuration, schedule, rendered HTML, lifecycle state, recipient counts, and engagement statistics.
- `LETTR_GET_DOMAIN` — Retrieve one sending domain's send readiness, DNS records, provider detection, and verification status.
- `LETTR_GET_EMAIL` — Retrieve a sent email's delivery state, recipients, schedule metadata, and events by request ID.

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

- `LETTR_ATTACH_CONTACTS_TO_LISTS` — Attach every combination of 1-1000 contacts and 1-50 audience lists, processing up to 50,000 contact-list pairs and reporting new and existing memberships.
- `LETTR_BULK_CREATE_AUDIENCE_CONTACTS` — Create or recognize up to 1000 normalized, deduplicated contacts.
- `LETTR_CANCEL_SCHEDULED_EMAIL` — Cancel a scheduled email before its delivery time; cancellation is unavailable once processing has begun.
- `LETTR_CREATE_AUDIENCE_CONTACT` — Create one audience contact with optional properties and list membership.
- `LETTR_CREATE_AUDIENCE_CONTACT_WITH_DOUBLE_OPT_IN` — Create an unverified audience contact and irreversibly send an external confirmation email; the contact becomes subscribed only after confirming.
- `LETTR_CREATE_AUDIENCE_LIST` — Create a uniquely named audience list for grouping contacts.
- `LETTR_CREATE_AUDIENCE_PROPERTY` — Define a custom contact property with an immutable name and value type.
- `LETTR_CREATE_AUDIENCE_SEGMENT` — Create a dynamic audience segment whose condition groups are ANDed while conditions inside each group are ORed.

## Frequently asked questions

### How does LuumenAI connect to Lettr?

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

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

### Is there an audit trail?

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

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