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
  }
}

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