Valley

Inbox

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

GET /public/v1/inbox/conversations

curl --request GET \
  --url 'https://api.joinvalley.co/public/v1/inbox/conversations' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "statusCode": 1,
  "status": true,
  "message": "<string>",
  "data": {
    "conversations": [
      {
        "id": "<string>",
        "status": "<string>",
        "conversation_medium": "<string>",
        "auto_pilot": true,
        "important": true,
        "created_at": "<string>",
        "updated_at": "<string>",
        "last_inbound_at": "<string>",
        "subject": "<string>",
        "campaign_id": "<string>",
        "campaign_name": "<string>",
        "campaign_type": "<string>"
      }
    ],
    "pagination": {
      "limit": 1,
      "offset": 1,
      "total": 1,
      "hasMore": true
    }
  }
}

Default Response

Authorizations

  • x-api-key string required header

    Your Valley API key.

Query Parameters

  • 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

    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

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

  • otherMessageType string enum

    Filter by message state: unread, response_ready, or 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

    Filter by prospect first or last name.

  • sort string enum

    Sort order. inbox view: by last_inbound_at (most recent prospect reply first); archived view: by updated_at. Defaults to newest.

  • tagIds string

    Comma-separated tag IDs to filter by.

  • to string

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

  • view string enum

    Required. "inbox" for active conversations, "archived" for archived ones.

  • workspaceId string

    Required. Scope to a specific workspace. Admins and owners see all campaigns in the workspace; members see only their own.

Response

application/json
  • statusCode number
  • status boolean
  • message string
  • data object
    + Show Child Attributes
    • conversations[] object array
      + Show Child Attributes
      • id string
      • status string nullable
      • conversation_medium string nullable
      • auto_pilot boolean
      • important boolean
      • created_at string
      • updated_at string
      • last_inbound_at string nullable
      • subject string nullable
      • campaign_id string
      • campaign_name string
      • campaign_type string
      • prospect_id string
      • prospect_first_name string nullable
      • prospect_last_name string nullable
      • prospect_linkedin_id string nullable
      • prospect_title string nullable
      • prospect_company string nullable
      • prospect_profile_picture string nullable
      • prospect_interest_level string nullable
      • prospect_icp_fit string nullable
      • unread_count number
      • last_message object nullable
        + Show Child Attributes
        • content string
        • sender string
        • is_read boolean
        • created_at string
    • pagination object
      + Show Child Attributes
      • limit number
      • offset number
      • total number
      • hasMore boolean