Valley

Inbox

GET /public/v1/approvals/messages

List outreach messages by approval status. Workspace admins and owners see messages from all campaigns in the workspace. Workspace members see only their own campaigns.

GET /public/v1/approvals/messages

GET /public/v1/approvals/messages

curl --request GET \
  --url 'https://api.joinvalley.co/public/v1/approvals/messages' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "statusCode": 1,
  "status": true,
  "message": "<string>",
  "data": {
    "messages": [
      {
        "id": "<string>",
        "message": "<string>",
        "status": "<string>",
        "type": "<string>",
        "subject": "<string>",
        "created_at": "<string>",
        "sent_at": "<string>",
        "approved_at": "<string>",
        "approved_by": "<string>",
        "is_read": true,
        "rating": 1,
        "campaign_id": "<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 messages to.

  • from string

    Filter messages 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).

  • offset number

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

  • 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 by message created_at. Defaults to newest.

  • tagIds string

    Comma-separated tag IDs to filter by.

  • to string

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

  • types string

    Comma-separated message types to filter by (e.g. CONNECT,INMAIL,FOLLOW_UP,RE_ENGAGEMENT).

  • view string enum

    Required. "pending" for messages awaiting approval, "approved" for approved messages, "scheduled" for messages scheduled to send.

  • 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
    • messages[] object array
      + Show Child Attributes
      • id string
      • message string nullable
      • status string
      • type string
      • subject string nullable
      • created_at string
      • sent_at string nullable
      • approved_at string nullable
      • approved_by string nullable
      • is_read boolean
      • rating number 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
      • prospect_status string
    • pagination object
      + Show Child Attributes
      • limit number
      • offset number
      • total number
      • hasMore boolean