GET /public/v1/inbox/conversations

List inbox conversations with filtering and pagination. Workspace admins and owners see conversations from all campaigns in the workspace. Workspace members see only their own campaigns.

GET /public/v1/inbox/conversations

API key in header x-api-key

curl --request GET \
  --url 'https://api.joinvalley.co/public/v1/inbox/conversations' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "statusCode": 1,
  "status": true,
  "message": "example",
  "data": {
    "conversations": [
      {
        "id": "id_01JXY9AZK4KV",
        "status": "example",
        "conversation_medium": "example",
        "auto_pilot": true,
        "important": true,
        "created_at": "2026-01-01T12:00:00Z",
        "updated_at": "2026-01-01T12:00:00Z",
        "last_inbound_at": "2026-01-01T12:00:00Z",
        "subject": "example",
        "campaign_id": "campaign_01JXY9AZK4KV",
        "campaign_name": "example",
        "campaign_type": "example",
        "prospect_id": "prospect_01JXY9AZK4KV",
        "prospect_first_name": "example",
        "prospect_last_name": "example",
        "prospect_linkedin_id": "prospect_linkedin_01JXY9AZK4KV",
        "prospect_title": "example",
        "prospect_company": "example",
        "prospect_profile_picture": "example",
        "prospect_interest_level": "example",
        "prospect_icp_fit": "example",
        "unread_count": 1,
        "last_message": {
          "content": "example",
          "sender": "example",
          "is_read": true,
          "created_at": "2026-01-01T12:00:00Z"
        }
      }
    ],
    "pagination": {
      "limit": 1,
      "offset": 1,
      "total": 1,
      "hasMore": true
    }
  }
}

Default Response

Query parameters

· 15

campaignIds string

Comma-separated campaign IDs to filter conversations to.

from string

Filter conversations created on or after this date (YYYY-MM-DD).

icpFit string

Comma-separated ICP fit values to filter by (e.g. STRONG,GOOD).

limit number · min: 1· max: 100· default: 20

Maximum number of records to return (1–100, default 20).

messageType string

Comma-separated message type filters (e.g. INMAIL_SENT, CONNECT_SENT, FOLLOWUP_SENT).

offset number · min: 0· default: 0

Number of records to skip. Capped at 1,000.

otherMessageType string · enum

Filter by message state: unread, response_ready, or reengagement_sent.

values

unread
response_ready
reengagement_sent

ownerId string

Admin/Owner only: scope results to a specific workspace member by their user ID.

prospectInterestLevel string

Comma-separated interest level values to filter by.

search string · max length: 200

Filter by prospect first or last name.

Query parameters

Responses