Conversations

A conversation is a unique thread of messages. It can appear in one or more inboxes (eg: if you receive an email on [email protected] where [email protected] is CC'd).

Even though a conversation message can have multiple recipients, the conversation resource will always have only one. The main recipient of a conversation can change over time depending on each message received. It will generally be the sender of the last incoming message.

Opening a conversation in Front
To open a conversation in Front you need to open the URL https://app.frontapp.com/open/{conversation_id}.

Fetching conversations

There are three primary ways to fetch conversations:

If you are looking to find conversations based on multiple parameters (such as a teammate and a tag, or multiple teammates), or compute a count of conversations matching certain criteria, we recommend using the search endpoint.

curl --request GET \
  --url 'https://api2.frontapp.com/conversations?q[statuses][]=unassigned&q[statuses][]=assigned'

Example Conversation Object

{
  "_links": {
    "self": "https://api2.frontapp.com/conversations/cnv_55c8c149",
    "related": {
      "events": "https://api2.frontapp.com/conversations/cnv_55c8c149/events",
      "followers": "https://api2.frontapp.com/conversations/cnv_55c8c149/followers",
      "messages": "https://api2.frontapp.com/conversations/cnv_55c8c149/messages",
      "comments": "https://api2.frontapp.com/conversations/cnv_55c8c149/comments",
      "inboxes": "https://api2.frontapp.com/conversations/cnv_55c8c149/inboxes",
      "last_message": "https://api2.frontapp.com/messages/msg_55c8c149"
    }
  },
  "id": "cnv_55c8c149",
  "subject": "You broke my heart, Hubert.",
  "status": "archived",
  "assignee": {
    "_links": {
      "self": "https://api2.frontapp.com/teammates/tea_55c8c149",
      "related": {
        "inboxes": "https://api2.frontapp.com/teammates/tea_55c8c149/inboxes",
        "conversations": "https://api2.frontapp.com/teammates/tea_55c8c149/conversations"
      }
    },
    "id": "tea_55c8c149",
    "email": "[email protected]",
    "username": "leela",
    "first_name": "Leela",
    "last_name": "Turanga",
    "is_admin": true,
    "is_available": true,
    "is_blocked": false
  },
  "recipient": {
    "_links": {
      "related": {
        "contact": "https://api2.frontapp.com/contacts/crd_55c8c149"
      }
    },
    "handle": "[email protected]",
    "role": "to"
  },
  "tags": [
    {
      "_links": {
        "self": "https://api2.frontapp.com/tags/tag_55c8c149",
        "related": {
          "conversations": "https://api2.frontapp.com/tags/tag_55c8c149/conversations",
          "owner": "https://api2.frontapp.com/teams/tim_55c8c149",
          "children": "https://api2.frontapp.com/tags/tag_55c8c149/children"
        }
      },
      "id": "tag_55c8c149",
      "name": "Robots",
      "highlight": "blue",
      "is_private": false,
      "created_at": 0,
      "updated_at": 0
    }
  ],
  "topics": [
    {
      "id": "top_3pjf1",
      "name": "ORD-1234",
      "type": "web",
      "link": "https://example.com/ORD-1234"
    }
  ],
  "created_at": 1453770984.123,
  "is_private": false
}