A message is a resource which can be either received or sent via an inbox. Messages are grouped by conversations.

A message can be either inbound (received) or outbound (sent). You can know if a message has been received or sent thanks to the boolean is_inbound.

Each message has a type depending on the channel it has been sent with:

emailEmail message
tweetMessage from Twitter
tweet_dmDirect Message from Twitter
smsSMS message
whatsappWhatsApp message
smoochMessage from Smooch
facebookMessage from Facebook
intercomMessage from Intercom
callPhone call
customCustom Message


Twitter notice

In order to comply with Twitter's API Terms & Conditions, Twitter content is not distributed through Front API.

The fields blurb, body, text as well as recipients' handle are replaced by the string [REDACTED] for messages of type tweet or tweet_dm only.

For those messages, the payload includes the field metadata.external_id containing the ID of the original Tweet or Twitter Direct Message that can be used to fetch its content from the Twitter API directly.

Opening a message in Front

To open a message in Front you need to open the URL{message_id}

Example Message Object

  "_links": {
    "self": "",
    "related": {
      "conversation": "",
      "message_replied_to": ""
  "id": "msg_55c8c149",
  "type": "email",
  "is_inbound": true,
  "is_draft": false,
  "created_at": 1453770984.123,
  "blurb": "Anything less than immortality is a...",
  "author": {
    "_links": {
      "self": "",
      "related": {
        "inboxes": "",
        "conversations": ""
    "id": "tea_55c8c149",
    "email": "[email protected]",
    "username": "leela",
    "first_name": "Leela",
    "last_name": "Turanga",
    "is_admin": true,
    "is_available": true,
    "is_blocked": false
  "recipients": [
      "_links": {
        "related": {
          "contact": ""
      "handle": "[email protected]",
      "role": "to"
  "body": "Anything less than immortality is a complete waste of time.",
  "text": "Anything less than immortality is a complete waste of time.",
  "attachments": [
      "filename": "attachment.jpg",
      "url": "",
      "content_type": "image/jpeg",
      "size": 10000,
      "metadata": {
        "is_inline": true,
        "cid": "123456789"
  "metadata": {}