Show Developer Menu

GET /messages

Issuing a GET call to messages will allow you to retrieve individual messages for all conversations in the Brand.

Alternative: GET /conversations/{slug}/messages

Alternatively, you can issue a GET to messages within a specific conversation to get messages scoped to that conversation.

Example Request
curl 'https://{brand}' \
  -u {login-email}:{api-token} \
  -H 'Accept: application/json'
Example Response
      "body":"I'm sorry, Dave. I'm afraid I can't do that.",
      "origin": 1,
      "user": {
        "name": "HAL",
        "email": ""
        "name": "Dave",
        "email": ""
        "file_file_name": "secret.png",
        "thumb_url": "",
        "url": "",
        "image?": true
      "conversation": {
        "subject":"Do you read me?",
        "category": {
Optional Params
  • filter with staff will show only staff messages and customer will show only customer messages.
  • page with any number will allow you to paginate through results. page_size and page_count are provided by the result.
  • sent_by with a value matching a known user email will return only messages sent by that user.
  • The visibility value can be the following values: 0 (Regular), 1 (Internal Note), or 2 (Collision Detected Message).
  • The origin value denotes where the message originated: Chat (0), Email (1), Twitter (2), Facebook (3), Classic Mode Chat (6), API (7), Instagram (8), SMS (9), Voice (10), Custom (11), WhatsApp (15), Staff Outbound (16), Contact Form (17), Instagram DM (19)
  • The recipients array is available for email messages and lists users (both staff and customers) who received an explicit email notification about this message. Note this is not necessarily the set of users who have access to the message.
  • The results are sorted by created_at in descending order.