---
title: "List LinkedIn conversations with last message preview (1-100, default 20). Returns chat_id (e.g. 'msg_abc123'). their_tu"
method: GET
path: "/api/v1/inbox/conversations"
tags: ["inbox"]
---

# List LinkedIn conversations with last message preview (1-100, default 20). Returns chat_id (e.g. 'msg_abc123'). their_tu

`GET /api/v1/inbox/conversations`

## Request

- Base URL: `https://crispy.sh`
- URL: `https://crispy.sh/api/v1/inbox/conversations`
- Auth: HTTP bearer

## Query parameters

- `limit` number: Max number of conversations to return (1-100, default 20)
- `cursor` string: Pagination cursor
- `label` string: Filter by label (e.g. 'Hot Lead', 'Client'). Use list_labels to see available labels.
- `campaign_id` string: Filter to conversations whose contact is enrolled in this campaign. Unknown or non-owned campaign_id returns an explicit NOT_FOUND error, never a silent empty list. Group conversations (contact_id=null) never match and are excluded. A contact enrolled in two campaigns appears under both filters — callers summing per-campaign counts must account for this.
- `include_archived` boolean: Include archived conversations (default false)
- `force_live` boolean: Bypass cache and fetch current state from LinkedIn (slower, use when cache seems stale).

## Response `200`

Success

## Other responses

- `401`: Missing or expired API key
- `403`: Insufficient key scope or permission denied
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/crispy/apis/crispy-rest-api.md) · [All operations](https://skmtc.dev/crispy/apis/crispy-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crispy/apis/crispy-rest-api/revisions/6bed0974d9ce?raw)