---
title: "Retell AI integration for LuumenAI"
url: "https://www.luumen.ai/integrations/retell-ai/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Retell AI integration for LuumenAI

Read agent, call, and chat config in Retell AI, then change it with approval

## What LuumenAI can do with Retell AI

LuumenAI connects to Retell AI with an API token and exposes 67 tools (28 read-only · 29 write · 10 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: 67 tools (28 read-only · 29 write · 10 destructive)
- Plan: available on all plans
- Category: AI & automation

## About Retell AI with LuumenAI

Connect Retell AI and your team can ask about voice agents, chat agents, conversation flows, and knowledge bases without opening the dashboard. Look up an agent's current version, check concurrency against your limits, then make the change — add a knowledge base source, run a batch test, start an outbound call — as a previewed step you approve first. Luumen connects with an API key.

## Example tools

Read-only (28 in total):

- `RETELLAI_GET_AGENT` — Retrieve details of a specific agent by its unique identifier.
- `RETELLAI_GET_AGENT_VERSIONS` — Retrieve all versions of a specific agent.
- `RETELLAI_GET_BATCH_TEST` — Retrieve details and results of a specific batch test job.
- `RETELLAI_GET_CHAT` — Retrieve details of a specific chat session by chat ID.
- `RETELLAI_GET_CHAT_AGENT` — Retrieve details of a specific chat agent by its unique identifier.
- `RETELLAI_GET_CHAT_AGENT_VERSIONS` — Retrieve all versions of a specific chat agent by its unique identifier.
- `RETELLAI_GET_CONCURRENCY` — Retrieves the current concurrency and concurrency limits for the organization.
- `RETELLAI_GET_CONVERSATION_FLOW` — Retrieve details of a specific Conversation Flow by its ID.

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

- `RETELLAI_ADD_COMMUNITY_VOICE` — Add a community voice from ElevenLabs to your Retell voice library.
- `RETELLAI_ADD_KNOWLEDGE_BASE_SOURCES` — Add sources (documents, URLs, text) to an existing knowledge base in Retell AI.
- `RETELLAI_BUY_A_NEW_PHONE_NUMBER_BIND_AGENTS` — This endpoint allows purchasing a new phone number with a specified area code and binding it to designated agents for inbound and outbound calls.
- `RETELLAI_CREATE_AGENT` — Create a new voice AI agent with specified configuration.
- `RETELLAI_CREATE_A_NEW_OUTBOUND_PHONE_CALL` — Initiate an outbound call by POST to '/v2/create-phone-call'.
- `RETELLAI_CREATE_A_NEW_WEB_CALL` — The /v2/create-web-call endpoint creates a web call with a unique agent ID, returning call details like type, token, call ID, and status in JSON format, with a 201 response.
- `RETELLAI_CREATE_BATCH_TEST` — Create a batch test job that runs multiple test cases against an agent.
- `RETELLAI_CREATE_CHAT` — Create a new chat session with a chat agent.

## Frequently asked questions

### How does LuumenAI connect to Retell AI?

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

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

### Is there an audit trail?

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

Full page: https://www.luumen.ai/integrations/retell-ai/