---
title: "Initiates a meeting session with the recall integration"
method: POST
path: "/integration/recall/{recallIntegrationId}/initiate"
tags: ["Conversation"]
---

# Initiates a meeting session with the recall integration

`POST /integration/recall/{recallIntegrationId}/initiate`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/integration/recall/{recallIntegrationId}/initiate`
- Auth: HTTP bearer

## Path parameters

- `recallIntegrationId` string, required: The ID of the recall integration to use

## Request body

- object
  - `meetingUrl` string, required: The URL of the meeting to join
  - `text` string, required: The instruction text to use to initiate the meeting session
  - `botName` string: The display name for the bot in the meeting

## Response `200`

The recall integration was successfully initiated

- object
  - `id` string, required: The ID of the recall integration
  - `bot` object, required: The meeting bot data from Recall.ai

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)