Retell Setup Guide

Overview

Integrating Retell with Roark lets you automatically send call data for evaluation, analytics, and reporting. Once connected, Roark will receive call recordings and metadata after each interaction, helping you monitor assistant performance and extract insights.

Prerequisites

Before setting up the integration, make sure you have:

✅ A Roark API Key - Generate one here
✅ A Retell AI Account & Agent - Sign up at Retell AI

Once you have these, follow the steps below to complete the integration.

Setup

Open Your Retell AI Agent Settings

Log in to your Retell AI account.
Navigate to the Agents List and select the agent you want to integrate.

Expand Webhook Settings

On the right sidebar, find the Webhook Settings panel.
Click on it to expand the settings.

Configure the Agent-Level Webhook URL

Retell AI only allows a single webhook. If you already have one configured, you can still send data to Roark by forwarding the payload from your existing webhook.

In the Agent Level Webhook URL field, enter: https://api.roark.ai/v1/integrations/retell?apiKey=YOUR_ROARK_API_KEY
Replace YOUR_ROARK_API_KEY with your actual API key from Roark.

Save Your Changes

Click Save to finalize your setup.

You’re all set! 🎉 Your Retell AI agent will now automatically send call recordings to Roark for analysis.

Open Your Retell AI Agent Settings

Log in to your Retell AI account.
Navigate to the Agents List and select the agent you want to integrate.

Expand Webhook Settings

On the right sidebar, find the Webhook Settings panel.
Click on it to expand the settings.

Configure the Agent-Level Webhook URL

Retell AI only allows a single webhook. If you already have one configured, you can still send data to Roark by forwarding the payload from your existing webhook.

In the Agent Level Webhook URL field, enter: https://api.roark.ai/v1/integrations/retell?apiKey=YOUR_ROARK_API_KEY
Replace YOUR_ROARK_API_KEY with your actual API key from Roark.

Save Your Changes

Click Save to finalize your setup.

You’re all set! 🎉 Your Retell AI agent will now automatically send call recordings to Roark for analysis.

If you’re already receiving Retell call events through your own webhook, you can simply forward the payload to Roark. This lets you trigger evaluations and analytics without changing your existing setup.

You can forward the data by sending a POST request to Roark’s webhook endpoint with the call metadata and recording URL. You can use tools like Node.js, Python, or any REST client. Optional custom properties can also be included.

You can find the full API specification in the API Reference.

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"retellCallEndedPayload":{"event":"call_ended", ... },"properties":{"business_name":"customer-business-name","business_id":"customer-business-id"}}'
};

fetch('https://api.roark.ai/v1/retell/call', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

🎉 You’re all set! Your Retell assistant is now integrated with Roark.

Getting Started

Tools

Integrations

SDKs

Overview

Prerequisites

Setup

Getting Started

Tools

Integrations

SDKs

​Overview

​Prerequisites

​Setup

Overview

Prerequisites

Setup