MOmonaco
Messages

Get Messages

Changed on

Returns conversation history of email and LinkedIn messages for a contact or account, merged into one recency-ordered feed.

Each row carries a conversation_id and channel. Pass both to get_conversation for the full thread.

post/v1/messages/list

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/messages/list
  • Auth
    none declared

Request body

contact_idstring uuid nullable

Scope to a single contact's message history

account_idstring uuid nullable

Scope to a single account's message history

cursorstring nullable

Opaque token from a previous response's next_cursor; omit for the first page

channelsChannelType[] nullable

Channels to include; omit or null returns all channels

page_sizeinteger

Example request

{
  "channels": [
    "email"
  ]
}

Response

Successful Response

next_cursorstring nullable

Pass back as cursor to fetch the next page; null when done

has_moreboolean required

Example response

{
  "data": [
    {
      "conversation_id": "thread_abc123",
      "subject": "Demo follow-up",
      "timestamp": "2026-03-01T10:00:00Z",
      "contact_id": "con_abc123",
      "account_id": "acc_abc123"
    }
  ]
}

Changes