Skip to main content
GET
/
v1
/
conversations
Get Conversations
curl --request GET \
  --url https://app-api.walead.ai/api/v1/conversations \
  --header 'x-api-key: <api-key>'
{
  "conversations": [
    {
      "conversationUrn": "<string>",
      "leadId": "<string>",
      "leadName": "<string>",
      "leadProfileUrl": "<string>",
      "lastMessage": "<string>",
      "lastMessageAt": "2023-11-07T05:31:56Z",
      "read": true,
      "campaignId": "<string>",
      "accountId": "<string>",
      "tags": [
        "<string>"
      ],
      "sentiment": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "total": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.walead.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Lists all conversations from your workspace inbox. Shows leads with active conversations and supports pagination and multiple filters.

​
Pagination

Results are paginated with 15 conversations per page. Use the page parameter (1-based) to navigate through pages.

​
Filters

You can filter conversations by:
  • campaign: Filter by campaign ID
  • account: Filter by LinkedIn account ID
  • search: Search by lead name or message content
  • read: Filter by read status (true/false)
  • tag: Filter by conversation tags
  • sentiment: Filter by sentiment classification

​
Use Cases

  • Build a custom inbox interface
  • Monitor conversations across all campaigns
  • Filter conversations by specific criteria
  • Search for specific leads or message content

​
Response

Returns an array of conversation objects with pagination information. Each conversation includes:
  • Basic lead information
  • Last message preview
  • Read status
  • Associated campaign and account
  • Tags and sentiment data

Authorizations

​
x-api-key
string
header
required

API key for authentication. Generate from your WaLead dashboard.

Query Parameters

​
page
string

Page number for pagination (1-based, 15 results per page)

​
campaign
string

Filter by campaign ID

​
account
string

Filter by LinkedIn account ID

​
search
string

Search conversations by lead name or message content

​
read
enum<string>

Filter by read status (true/false)

Available options:
true,
false
​
tag
string

Filter by tag

​
sentiment
string

Filter by sentiment classification

Response

Conversations retrieved successfully

​
conversations
object[]
​
pagination
object