Conversations

List Conversations

List conversations from email inbox or LinkedIn inbox with filtering and pagination. Use channel to filter by platform. Use last_message_direction to filter by who sent the last message:

  • inbound = replies from contacts (needs your response)
  • outbound = your sent messages (waiting on their reply)
get/conversations

Query parameters

team_idstring uuid

Filter by team ID (UUID from list teams)

channel'email' | 'linkedin'

Which inbox to list (email or linkedin)

last_message_direction'inbound' | 'outbound'

Filter by who sent the last message; inbound = replies from contacts, outbound = your sent messages

identity_idstring uuid

Filter by identity ID

status'archived' | 'unarchived'

Filter by archive status

read_status'read' | 'unread'

Filter by read status

searchstring

Search in conversation title, messages, or contact details

sort_by'date'

Sort field (default date)

sort_direction'asc' | 'desc'

Sort order

limitinteger

Number of items to return

offsetinteger

Number of items to skip

Response

List of conversations

successboolean
request_idstring

Example response

{
  "success": true,
  "request_id": "req_abc123def456"
}

Changes