OMomnisocials
Inbox

List messages

Changed on

Returns the full message history of a conversation, oldest first, cursor-paginated. Requires the inbox:read scope (API keys) or the access_social_inbox permission (OAuth/MCP).

get/inbox/conversations/{conversationId}/messages

Request

  • Base URL
    https://api.omnisocials.com/v1
  • URL
    https://api.omnisocials.com/v1/inbox/conversations/{conversationId}/messages
  • Auth
    HTTP bearer

Path parameters

conversationIdstring required
Example:instagram_comment_17912345678901234

Query parameters

limitinteger
cursorstring
Example:MjAyNi0xMC0yMVQwOTowMDowMC4wMDBafDg4MjMx

Response

A page of messages

Example response

{
  "data": [
    {
      "id": "88231",
      "conversation_id": "instagram_comment_17912345678901234",
      "platform": "instagram",
      "type": "comment",
      "text": "What size is this?",
      "timestamp": "2026-10-21T09:00:00.000Z",
      "attachment": {
        "url": "https://example.com/photo.jpg"
      },
      "sender": {
        "name": "Jamie Rivera",
        "username": "jamierivera",
        "profile_picture": "https://example.com/avatar.jpg"
      },
      "post": {
        "id": "17912345678901234",
        "caption": "Our autumn menu is here. #autumnmenu",
        "thumbnail": "https://example.com/photo.jpg",
        "url": "https://www.instagram.com/p/Cxyz123ABC/",
        "media_type": "IMAGE"
      }
    }
  ],
  "pagination": {
    "next_cursor": "MjAyNi0xMC0yMVQwOTowMDowMC4wMDBafDg4MjMx",
    "has_more": true,
    "limit": 25
  }
}

Changes

  • 79cdeec29f82Revision changes
    • info

      added the optional property // to the response with the status

  • bff746fd6191Revision changes
    • warning

      added the new link enum value to the /// response property for the response status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status