---
title: "Trigger extract integration on historic conversations"
method: POST
path: "/integration/extract/{extractIntegrationId}/trigger"
tags: ["Extract Integration"]
---

# Trigger extract integration on historic conversations

`POST /integration/extract/{extractIntegrationId}/trigger`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/integration/extract/{extractIntegrationId}/trigger`
- Auth: HTTP bearer

## Path parameters

- `extractIntegrationId` string, required: The ID of the Extract integration

## Request body

- object
  - `conversationIds` string[]: Array of conversation IDs to process
  - `sample` integer: Number of recent conversations to process (default 20)

## Response `200`

Extract integration trigger initiated successfully

- object
  - `id` string, required: ID of the extract integration
  - `triggered` number, required: Number of conversations queued for processing

## 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)