> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs Webhook Setup Guide

> Configure ElevenLabs to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](https://docs.stackone.com/connectors/elevenlabs.md#getting-started) on the ElevenLabs connector page.

## Register the StackOne webhook in ElevenLabs

This connector uses manual webhooks. You create one webhook endpoint in ElevenLabs that points at StackOne, subscribe it to the workspace events you need, and select it as the post-call webhook for agent events. ElevenLabs sends no verification ping; events are delivered as soon as the endpoint exists.

**1. Retrieve the StackOne Native Webhook URL**

The **Native Webhook URL** is generated once your ElevenLabs account has been linked in StackOne.

<ul>
  <li>Open the linked account in StackOne.</li>
  <li>Copy the value from **Native Webhook URL**. It is unique to this account, so copy it exactly.</li>
</ul>

**2. Open Webhooks in ElevenLabs**

Sign in to your [ElevenLabs account](https://elevenlabs.io/app/sign-in), switch to **ElevenAPI** with the platform switcher, then click **Webhooks** in the sidebar and click **Add endpoint**.

![ElevenAPI Webhooks page with Webhooks in the sidebar and the Add endpoint button highlighted](https://mintcdn.com/stackone-60/W0fV4KStEczYCt6v/connectors/elevenlabs/images/events-open-webhooks.png?fit=max\&auto=format\&n=W0fV4KStEczYCt6v\&q=85\&s=009a7314da36835b690508c2b06c0d2e)

**3. Add the endpoint and select events**

In the **Add endpoint** dialog, paste the StackOne **Native Webhook URL** into **Endpoint URL** and optionally add a **Description**. Under **Select events to listen to**, tick the workspace events you want delivered, then click **Add endpoint**.

<ul>
  <li>**Voice removal notice** delivers the voice removal events.</li>
  <li>**Transcription completed** delivers asynchronous speech-to-text results.</li>
  <li>**Image & Video API generation completed** delivers image and video generation results.</li>
</ul>

![Add endpoint dialog with the Endpoint URL field and the three event options highlighted](https://mintcdn.com/stackone-60/W0fV4KStEczYCt6v/connectors/elevenlabs/images/events-add-endpoint.png?fit=max\&auto=format\&n=W0fV4KStEczYCt6v\&q=85\&s=8036988fa920121c3ccc27e56cc1ba09)

**4. Save the webhook secret**

ElevenLabs then shows the **Webhook secret** dialog. Click **Copy to Clipboard** and store the secret securely for use later. ElevenLabs signs every delivery with it in the `ElevenLabs-Signature` header.

<ul>
  <li>The webhook secret is only displayed once and cannot be retrieved later.</li>
</ul>

![Webhook secret dialog with the secret hidden and the Copy to Clipboard button highlighted](https://mintcdn.com/stackone-60/W0fV4KStEczYCt6v/connectors/elevenlabs/images/events-webhook-secret.png?fit=max\&auto=format\&n=W0fV4KStEczYCt6v\&q=85\&s=64de76cfc7b0a5ca7fc12f200ba4716e)

**5. Check the endpoint is enabled**

The new endpoint appears in the **Webhooks** list. Make sure the **ENABLED** toggle is on.

![Webhooks list with the new endpoint and its ENABLED toggle highlighted](https://mintcdn.com/stackone-60/W0fV4KStEczYCt6v/connectors/elevenlabs/images/events-endpoint-enabled.png?fit=max\&auto=format\&n=W0fV4KStEczYCt6v\&q=85\&s=9014b5cda6085b13886c86e77957c8c1)

## Send agent post-call events to StackOne

Agent call events use the workspace post-call webhook, which is set in the ElevenAgents settings rather than in the endpoint's event list. Skip this section if you do not use ElevenLabs agents.

**1. Open the post-call webhook setting**

Switch to **ElevenAgents** with the platform switcher and open the agents **Settings** page. In **Post-Call Webhook**, click **Select Webhook** and choose the endpoint you created.

<ul>
  <li>Agents can override the workspace post-call webhook on their Security tab.</li>
</ul>

![Agents settings page with the Select Webhook button in the Post-Call Webhook section highlighted](https://mintcdn.com/stackone-60/W0fV4KStEczYCt6v/connectors/elevenlabs/images/events-post-call-webhook.png?fit=max\&auto=format\&n=W0fV4KStEczYCt6v\&q=85\&s=f3aa5005c5385967c077befe797fadae)

**2. Select the post-call events**

Under **Webhook Events**, tick the events to send. At least one event must be selected. The change saves automatically.

<ul>
  <li>**Transcript** sends conversation analysis and metadata.</li>
  <li>**Audio** sends a secondary webhook with the audio data for each conversation.</li>
  <li>**Call Initiation Failures** sends an event when telephony calls fail to initiate or are rejected by concurrency or daily call limits.</li>
  <li>**Answering Machine Detection** is not mapped by StackOne, so leave it unticked.</li>
</ul>

![Post-Call Webhook section with Transcript, Audio and Call Initiation Failures checked](https://mintcdn.com/stackone-60/W0fV4KStEczYCt6v/connectors/elevenlabs/images/events-post-call-events.png?fit=max\&auto=format\&n=W0fV4KStEczYCt6v\&q=85\&s=a217317e9deb49198a1f5f2e6a3a0823)

## Available webhook events

The following ElevenLabs events are delivered to StackOne. Only events you select in ElevenLabs are sent; ElevenLabs does not deliver events you did not subscribe to.

**1. Agent events**

Events sent through the post-call webhook when an agent conversation ends.

<ul>
  <li>**Post-Call Transcription** (`post_call_transcription`) — Fired when an agent call has finished and analysis is complete, with the transcript, analysis and metadata</li>
  <li>**Post-Call Audio** (`post_call_audio`) — Fired with the full audio of a finished agent call as base64-encoded MP3</li>
  <li>**Call Initiation Failure** (`call_initiation_failure`) — Fired when an outbound agent call fails to start, with the failure reason</li>
</ul>

**2. Voice events**

Events sent when a Voice Library voice used in the workspace changes status.

<ul>
  <li>**Voice Removal Notice** (`voice_removal_notice`) — Fired when a shared library voice you use is scheduled for removal</li>
  <li>**Voice Removal Notice Withdrawn** (`voice_removal_notice_withdrawn`) — Fired when a scheduled shared voice removal is canceled</li>
  <li>**Voice Removed** (`voice_removed`) — Fired when a shared library voice has been removed and can no longer be used</li>
</ul>

**3. Speech to text and generation events**

Events sent when asynchronous work finishes.

<ul>
  <li>**Speech to Text Transcription** (`speech_to_text_transcription`) — Fired when an asynchronous speech-to-text request made with the webhook parameter finishes</li>
  <li>**Image and Video Generation** (`flows_generation`) — Fired when an Image & Video API generation completes or fails</li>
</ul>

## Delivery format

Details of how ElevenLabs delivers events to StackOne.

**1. One event per request**

Each request carries a single JSON event with `type`, `event_timestamp` and `data`. StackOne routes it to the matching event handler by `type`.

**2. Retries and auto-disable**

A delivery that does not return 200 is retried with increasing delays. ElevenLabs disables a webhook after 10 or more consecutive failures when the last successful delivery was more than 7 days ago, so check the **ENABLED** toggle if events stop arriving.

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.