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

# AimTell integration for LuumenAI

Read AimTell campaigns, segments, and delivery data, then draft sends with approval

## What LuumenAI can do with AimTell

LuumenAI connects to AimTell with an API token and exposes 15 tools (7 read-only · 5 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: 15 tools (7 read-only · 5 write · 3 destructive)
- Plan: available on all plans
- Category: Communication

## About AimTell with LuumenAI

Connect AimTell and Luumen can read your websites, subscribers, segments, campaigns, and the last seven days of notification logs without leaving the terminal. Ask why a send underdelivered, or which segment a subscriber falls into. When a change is needed — a new segment, a campaign draft, a one-off push — Luumen shows the plan first and waits for your approval by default.

## Example tools

Read-only (7 in total):

- `AIMTELL_GET_ANALYTICS_OVER_TIME` — Return a daily AimTell metric over a date range for all websites or one website.
- `AIMTELL_GET_CAMPAIGN_RESULTS` — Return daily send, delivery, bounce, click, conversion, and available revenue results for a manual, event-triggered, RSS, or welcome campaign.
- `AIMTELL_LIST_CAMPAIGNS` — Return one page of manual, event-triggered, RSS, or API push campaigns for an AimTell website.
- `AIMTELL_LIST_NOTIFICATION_LOGS` — Return one page from AimTell's sampled notification log for the last seven days, optionally filtered to one subscriber.
- `AIMTELL_LIST_SEGMENTS` — Return all audience segments for an AimTell website, including the IDs and definitions used for subscriber filtering and campaign targeting.
- `AIMTELL_LIST_SUBSCRIBERS` — Return one page of subscribers for an AimTell website, optionally filtered by segment or subscriber ID and optionally including attributes or notification history.
- `AIMTELL_LIST_WEBSITES` — Return one page of websites available to the connected AimTell account, including site IDs needed by other tools.

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

- `AIMTELL_CREATE_MANUAL_CAMPAIGN` — Create a manual push campaign as a draft only; this tool never schedules or sends it.
- `AIMTELL_CREATE_SEGMENT` — Create a named audience segment for a website from an AimTell segment definition.
- `AIMTELL_DELETE_MANUAL_CAMPAIGN` — Permanently delete one manual campaign by ID.
- `AIMTELL_DELETE_SEGMENT` — Permanently delete one audience segment by ID.
- `AIMTELL_SEND_PUSH_NOTIFICATION` — Immediately send a one-off push notification to exactly one explicitly selected audience: subscriber IDs, one segment, one alias, or the website's full reachable audience.
- `AIMTELL_SET_SUBSCRIBER_ATTRIBUTES` — Set custom attributes on one subscriber identified by subscriber UID, user alias, or email alias; supplied aliases may also be associated with the subscriber.
- `AIMTELL_UPDATE_MANUAL_CAMPAIGN` — Update the content or targeting of an unscheduled, unsent, non-A/B manual campaign draft without scheduling or sending it.
- `AIMTELL_UPDATE_SEGMENT` — Change the name or audience definition of an existing AimTell segment.

## Frequently asked questions

### How does LuumenAI connect to AimTell?

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

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