Retell AI + Konnectify
Retell AI Integration with Konnectify
Connect Retell AI to Konnectify to orchestrate voice AI and telephony automation—initiate and manage calls and chats, sync agent and conversation assets, and build knowledge bases that power real-time customer interactions.
Calls Chats Agents Knowledge Bases Phone Numbers Voices 1 Trigger 23 Actions
What is Retell AI?
Retell AI is a voice AI platform for building and operating AI-powered voice agents that can handle real phone calls and web calls. It combines telephony, LLM-driven dialog, and operational tooling (agents, voices, call recordings, and knowledge bases) to run automated conversations at scale.
With Konnectify, you can automate how calls and chats are initiated, tracked, and updated—while keeping your agent configuration, knowledge base sources, and call outcomes in sync with the rest of your business stack.
New to Retell AI?
Create your Retell AI workspace, set up agents, and generate an API key to connect.
Visit Retell AI →What you can automate
• Purchase, look up, or delete Retell phone numbers
• Initiate phone calls, web calls, and batch call campaigns
• Register pre-existing calls and update call states/metadata
• Create, update, and end chat sessions for agents
• Create and maintain knowledge bases and their sources
• Retrieve voice agents, LLMs, conversation flows, and available voices
API & Authentication
Authentication type: API Key (credentials)
Konnectify connects to Retell AI using an API Key. You’ll paste your Retell API key into the Retell AI connection in Konnectify. Keep this key secure—anyone with access can make API requests on your behalf.
- Where to find it: In your Retell AI dashboard (API / developer settings).
- How it’s used: Sent with each request to authenticate and authorize operations like calls, chats, knowledge bases, and voices.
What the Retell AI connection can do
Based on available triggers and actions in this connector, Konnectify can access these functional areas:
- Calls: create calls/web calls/batch calls, update calls, retrieve call details and recordings, register external calls.
- Chats: create, retrieve, update, and end chat sessions.
- Agents & flows: retrieve voice agents, chat agents, Retell LLMs, and conversation flows.
- Phone numbers: create (purchase/setup), find, and delete phone numbers.
- Knowledge bases: create, add sources, retrieve, and delete knowledge bases.
- Voices: add/clone voices, get voice details, and search voices.
Important: plan restrictions & rate limits Retell AI features (e.g., phone number purchasing, call concurrency, recordings, knowledge base limits) can vary by plan and region. Additionally, API rate limits may apply. If a workflow runs at high volume (batch calls, frequent polling), add retries/backoff and avoid unnecessary calls.
Official docs: refer to Retell AI’s API documentation for endpoint details, required fields, and limits. Retell AI documentation →
How to connect Retell AI to Konnectify
Prerequisites
- A Retell AI account with API access enabled
- Your Retell AI API Key
- In Retell AI: at least one agent/voice configured (required for initiating calls/chats)
- A Konnectify account and permission to create/edit workflows
Add Retell AI to a Workflow
- Create a new Workflow in Konnectify (or open an existing one).
- Click Add step and search for Retell AI.
- Select a Trigger (to start the workflow) or an Action (to perform an operation).
Authorize via API Key authentication
- When prompted, create/select a Retell AI connection.
- Paste your API Key into the connection field.
- Save. Konnectify will validate the key when making requests.
Configure the Trigger or Action
- Choose the Retell AI event (Trigger) or operation (Action) you need.
- Map required fields using outputs from previous steps (e.g., phone number, agent ID, dynamic variables).
- Use test data to validate configuration before moving on.
Warning For call-initiating actions (Create Call / Create Web Call / Create Batch Call), ensure the agent/voice configuration exists in Retell AI and that the destination number and region/permissions are allowed by your Retell plan.
Test the Workflow
- Run a test to confirm Retell AI returns the expected objects (call/chat/agent details).
- Check mapped fields carefully (IDs, phone numbers, dynamic variables).
- Review step logs for errors and retry behavior.
Activate the Workflow
- Turn on the workflow.
- Monitor early runs to confirm call/chat creation and updates behave as expected.
- Iterate: add filters, retries, and notifications for production reliability.
Triggers 1
This connector includes 1 trigger. The available trigger is polling-based, meaning Konnectify checks Retell AI at intervals to detect new or updated records.
Calls 1 triggers
New CallTriggers when a new call is registered or completed.
Actions 23
Use actions to create and manage calls, chats, agents, knowledge bases, voices, and phone numbers in Retell AI.
Calls 7 actions
Create CallInitiate a new phone call using an agent.
Create Web CallInitiate a new web call using a voice agent.
Update CallUpdate an existing phone call.
Get callRetrieve details and recording of a specific call.
Register Phone CallRegister a pre-existing or custom mapped phone call (v2).
Create Batch CallInitiate a batch of phone calls simultaneously.
Create ChatCreate a new chat session with a voice agent.
Note: “Create Chat” is listed under Calls because it commonly pairs with call workflows; see the Chats module for chat management actions.
Chats 4 actions
Create ChatCreate a new chat session with a voice agent.
Get ChatRetrieve details of a specific chat session.
Update ChatUpdate metadata or dynamic variables of a chat.
End ChatForcefully end an ongoing chat session.
Phone Numbers 3 actions
Create Phone numberPurchase or setup a new phone number in Retell.
Find Phone numberRetrieve details for a specific phone number.
Delete Phone NumberDelete an existing phone number from your Retell account.
Knowledge Bases 4 actions
Create Knowledge BaseUpload texts, urls, or files to create a knowledge base.
Add Knowledge Base SourcesUpload texts, URLs, or files to an existing knowledge base.
Get Knowledge BaseRetrieve details of a specific knowledge base.
Delete Knowledge BaseDelete an existing knowledge base from your Retell account.
Agents & Flows 4 actions
Get Chat AgentRetrieve details of a specific chat agent.
Get Voice AgentRetrieve details of a specific voice agent.
Get Retell LLMRetrieve details of a specific Retell LLM.
Get Conversation FlowRetrieve details of a specific conversation flow.
Voices 3 actions
Add VoiceClone or add a provider voice.
Get VoiceRetrieve details of a specific voice.
Search VoicesFilter and search through available voices.
Popular automations
Examples of common Retell AI workflows you can build in Konnectify using the trigger and actions available in this connector.
Post-call enrichment & recording retrieval
When a new call is registered or completed, fetch the full call details (including recording metadata) for downstream routing and storage.
New Call → Get call
Keep an agent’s knowledge base current
Create a knowledge base for a new product/help center and continuously add new sources as your content evolves.
Create Knowledge Base → Add Knowledge Base Sources → Get Knowledge Base
Spin up outbound calling quickly
Provision a phone number and use it to initiate outbound calls from a configured agent for appointment reminders, follow-ups, or qualification.
Create Phone number → Create Call
Automated web chat lifecycle management
Start a chat for a user, update dynamic variables as context changes, and end the chat when your workflow completes.
Create Chat → Update Chat → End Chat
FAQ
How does Konnectify authenticate with Retell AI?
Konnectify uses API Key authentication. You provide your Retell AI API key when creating the connection, and Konnectify sends it with each request to authorize actions like creating calls and managing chats/knowledge bases.
Which Retell AI plans are supported?
Any Retell AI plan that provides API access should work. Features like phone number provisioning, concurrent calling, recordings, and knowledge base limits may vary by plan and region—confirm capabilities in your Retell AI account.
Are Retell AI triggers webhook-based or polling-based?
The New Call trigger is polling-based. Konnectify checks Retell AI periodically to detect new/updated calls. If you need near real-time behavior, consider shorter polling intervals (within rate limits) or combine with external events that start a workflow.
How do I prevent duplicate processing of the same call?
This connector does not include an “upsert” action, so deduplication should be handled in your workflow. Use a unique identifier (e.g., call ID) and store it in your datastore/CRM, or add a Konnectify filter step to skip if the ID was already processed.
What happens if Retell AI rate limits my workflow?
If Retell AI returns rate-limit responses, reduce polling frequency, avoid unnecessary “Get” calls, and add retry/backoff in your workflow design. Batch operations (like Create Batch Call) can also concentrate traffic—plan concurrency accordingly.
Can I connect multiple Retell AI accounts to Konnectify?
Yes. Create separate Retell AI connections in Konnectify—each with its own API key—and choose the desired connection per workflow step (useful for managing multiple workspaces/environments).
How should I handle call recordings and sensitive data?
Use Get call to retrieve recording metadata/details, then store only what you need. Follow your organization’s privacy and consent requirements for call recording, apply least-privilege access to API keys, and avoid logging sensitive fields in workflow logs where possible.
Ready to automate your Retell AI workflows?
Connect Retell AI to Konnectify to launch voice AI automations across calls, chats, knowledge bases, and more.
Get started free →