Enable conversation ended webhook

Enable webhook notifications when a chat conversation ends

Updated 24 Mar 2026

On this page

This endpoint enables conversation ended webhook notifications for an assistant, allowing you to receive real-time updates when a chat conversation (WhatsApp or Web Widget) ends. The webhook includes the full transcript, extracted variables, and customer information.

Request Body

assistant_idintegerrequired

The ID of the assistant to enable the conversation ended webhook for

webhook_urlstringrequired

The URL where webhook notifications will be sent when a conversation ends

Response

messagestring

Success message confirming webhook was enabled

dataarray

Empty array (reserved for future use)

Error Responses

404 Not Found

messagestring

  Error message when the assistant is not found or doesn't belong to the authenticated user

422 Validation Error

messagestring

  Error message indicating validation failure

errorsobject

  Detailed validation errors for each field

{
  "message": "Conversation ended webhook enabled successfully",
  "data": []
}

{
  "message": "Assistant not found"
}

{
  "message": "The given data was invalid.",
  "errors": {
    "assistant_id": [
      "The assistant id field is required."
    ],
    "webhook_url": [
      "The webhook url field is required."
    ]
  }
}

Related guides

API Reference

Introduction

Welcome to the VoxLink API

Read guide →

API Reference

Authentication

Learn how to authenticate your API requests

Read guide →

API Reference

Get current user

Get the authenticated user's profile information

Read guide →

API Reference

List assistants

List all assistants for the authenticated user with pagination

Read guide →