---
title: "List conversation events"
method: GET
path: "/conversations/{conversation_id}/events"
tags: ["Conversations"]
---

# List conversation events

`GET /conversations/{conversation_id}/events`

List the events that occured for a conversation in reverse chronological order (newest first). The order will respect your company's [bump settings](https://help.front.com/t/y729th/customize-when-conversations-bump-up), which determine when conversations bump to the top.

Required scope: `events:*:read`

## Path parameters

- `conversation_id` string, required

## Query parameters

- `limit` integer
- `page_token` string

## Response `200`

Array of events

- object
  - `_pagination` object
    - `next` string, nullable — Link to next [page of results](https://dev.frontapp.com/docs/pagination)
  - `_links` object
    - `self` string — Link to resource
  - `_results` EventResponse[]
    - `_links` object
      - `self` string — Link to resource
    - `id` string — Unique identifier of the event
    - `type` 'assign' | 'unassign' | 'archive' | 'reopen' | 'trash' | 'restore' | 'reminder' | 'comment' | 'mention' | 'inbound' | 'outbound' | 'out_reply' | 'move' | 'forward' | 'tag' | 'untag' | 'sending_error' | 'message_bounce_error' | 'conversations_merged' | 'link_added' | 'link_removed' | 'custom_field_updated' | 'macro_triggered' | 'topic_identified' | 'ticket_status_update' | 'call_started' | 'call_abandoned' | 'call_queued' | 'call_on_hold' | 'call_resumed' | 'call_connected' | 'call_missed' | 'call_hangup' | 'call_transferred' | 'call_transcript_added' | 'call_voicemail_transcript_added' — Type of event
    - `emitted_at` number — The timestamp when the event has been emitted
    - `source` object — Event source
      - `_meta` object — Metadata about the resource
        - `type` 'api' | 'oauth_client' | 'rule' | 'teammate' | 'imap' | 'gmail' | 'reminder' | 'inboxes' | 'recipient' — Type of resource
      - `data` union — The resource which triggered the event
        - RuleResponse
          - `_links` object, required
            - `self` string — Link to resource
            - `related` object
              - …
          - `id` string, required — Unique identifier of the rule
          - `name` string, required — Name of the rule
          - `actions` string[], required — List of the rule's actions description
          - `is_private` boolean, required — Whether or not the rule is individual
        - TeammateResponse — A teammate is a user in Front.
          - `_links` object, required
            - `self` string — Link to resource
            - `related` object
              - …
          - `id` string, required — Unique identifier of the teammate
          - `email` string, required — Email address of the teammate
          - `username` string, required — Username of the teammate (used for "@" mentions)
          - `first_name` string, required — First name of the teammate
          - `last_name` string, required — Last name of the teammate
          - `is_admin` boolean, required — Whether or not the teammate is an admin in your company
          - `is_available` boolean, required — Whether or not the teammate is available
          - `is_blocked` boolean, required — Whether or not the teammate account has been blocked
          - `type` 'user' | 'visitor' | 'ai' | 'api' | 'application' | 'bulk_reply' | 'csat' | 'integration' | 'macro' | 'rule' | 'smart_csat', required — Type of the teammate, normal teammates are denoted as "user", while visitors are denoted as "visitor". Bot users are denoted by their parent resource type. The following bot types are available: * ai: acting on behalf of an AI * api: acting on behalf of OAuth clients * application: acting on behalf of an Application * bulk_reply: acting on behalf of a Bulk Reply * csat: used for authoring CSAT response comments * integration: acting on behalf of an Integration * macro: acting on behalf of a Macro, author of comments and drafts * rule: acting on behalf of a Rule, author of comments and drafts * smart_csat: acting on behalf of a Smart CSAT
          - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
        - InboxResponse[]
          - `_links` object
            - `self` string — Link to resource
            - `related` object
              - …
          - `id` string — Unique identifier for the inbox
          - `name` string — Name of the inbox
          - `is_private` boolean — Whether or not the inbox is individual
          - `is_public` boolean — Whether or not the inbox is available to all members of a team by default
          - `custom_fields` CustomFieldParameter — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
    - `target` object — Partial representation (type & id) of the event's target
      - `_meta` object — Metadata about the resource
        - `type` 'teammate' | 'inboxes' | 'message' | 'comment' | 'tag' | 'deleted_conversation_ids' | 'link' | 'custom_field' — Type of resource
      - `data` union — The resource which received the event
        - TeammateResponse — A teammate is a user in Front.
          - `_links` object, required
            - `self` string — Link to resource
            - `related` object
              - …
          - `id` string, required — Unique identifier of the teammate
          - `email` string, required — Email address of the teammate
          - `username` string, required — Username of the teammate (used for "@" mentions)
          - `first_name` string, required — First name of the teammate
          - `last_name` string, required — Last name of the teammate
          - `is_admin` boolean, required — Whether or not the teammate is an admin in your company
          - `is_available` boolean, required — Whether or not the teammate is available
          - `is_blocked` boolean, required — Whether or not the teammate account has been blocked
          - `type` 'user' | 'visitor' | 'ai' | 'api' | 'application' | 'bulk_reply' | 'csat' | 'integration' | 'macro' | 'rule' | 'smart_csat', required — Type of the teammate, normal teammates are denoted as "user", while visitors are denoted as "visitor". Bot users are denoted by their parent resource type. The following bot types are available: * ai: acting on behalf of an AI * api: acting on behalf of OAuth clients * application: acting on behalf of an Application * bulk_reply: acting on behalf of a Bulk Reply * csat: used for authoring CSAT response comments * integration: acting on behalf of an Integration * macro: acting on behalf of a Macro, author of comments and drafts * rule: acting on behalf of a Rule, author of comments and drafts * smart_csat: acting on behalf of a Smart CSAT
          - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
        - InboxResponse
          - `_links` object
            - `self` string — Link to resource
            - `related` object
              - …
          - `id` string — Unique identifier for the inbox
          - `name` string — Name of the inbox
          - `is_private` boolean — Whether or not the inbox is individual
          - `is_public` boolean — Whether or not the inbox is available to all members of a team by default
          - `custom_fields` CustomFieldParameter — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
        - TagResponse — A tag is a label that can be used to classify conversations.
          - `_links` object, required
            - `self` string — Link to resource
            - `related` object
              - …
          - `id` string, required — Unique identifier of the tag
          - `name` string, required — Name of the tag
          - `description` string, nullable, required — Description of the tag
          - `highlight` string, nullable, required — Highlight color or emoji of the tag. Null if the tag does not have a highlight.
          - `is_private` boolean, required — Whether or not the tag is individual
          - `is_visible_in_conversation_lists` boolean, required — Whether the tag is visible in conversation lists.
          - `created_at` number — Timestamp of tag create creation
          - `updated_at` number — Timestamp of the last tag update
        - CommentResponse
          - `_links` object, required
            - `self` string — Link to resource
            - `related` object
              - …
          - `id` string, required — Unique identifier of the comment
          - `author` TeammateResponse, required — A teammate is a user in Front.
            - `_links` object, required
              - …
            - `id` string, required — Unique identifier of the teammate
            - `email` string, required — Email address of the teammate
            - `username` string, required — Username of the teammate (used for "@" mentions)
            - `first_name` string, required — First name of the teammate
            - `last_name` string, required — Last name of the teammate
            - `is_admin` boolean, required — Whether or not the teammate is an admin in your company
            - `is_available` boolean, required — Whether or not the teammate is available
            - `is_blocked` boolean, required — Whether or not the teammate account has been blocked
            - `type` 'user' | 'visitor' | 'ai' | 'api' | 'application' | 'bulk_reply' | 'csat' | 'integration' | 'macro' | 'rule' | 'smart_csat', required — Type of the teammate, normal teammates are denoted as "user", while visitors are denoted as "visitor". Bot users are denoted by their parent resource type. The following bot types are available: * ai: acting on behalf of an AI * api: acting on behalf of OAuth clients * application: acting on behalf of an Application * bulk_reply: acting on behalf of a Bulk Reply * csat: used for authoring CSAT response comments * integration: acting on behalf of an Integration * macro: acting on behalf of a Macro, author of comments and drafts * rule: acting on behalf of a Rule, author of comments and drafts * smart_csat: acting on behalf of a Smart CSAT
            - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
          - `body` string, required — Content of the comment
          - `posted_at` number — The timestamp when the comment was posted
          - `attachments` Attachment[], required — List of files attached to the comment
            - `id` string, required — The unique identifier of the attachment.
            - `filename` string, required — Name of the attached file
            - `url` string, required — URL to download the attached file
            - `content_type` string, required — Content type of the attached file in [MIME format](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types). Note that some attachments types may not be supported.
            - `size` integer, required — Size (in byte) of the attached file
            - `metadata` object, required — Attachment metadata
              - …
          - `is_pinned` boolean, required — Whether or not the comment is pinned in its conversation
        - MessageResponse
          - `_links` object
            - `self` string — Link to resource
            - `related` object
              - …
          - `id` string — Unique identifier of the message
          - `message_uid` string — Secondary unique identifier of a message. Generated by Front on message creation. Learn more at about the [message UID](https://dev.frontapp.com/reference/messages#creating-a-new-message).
          - `type` 'call' | 'custom' | 'email' | 'facebook' | 'front_chat' | 'googleplay' | 'intercom' | 'internal' | 'phone-call' | 'sms' | 'tweet' | 'tweet_dm' | 'whatsapp' | 'yalo_wha' — Type of the message
          - `is_inbound` boolean — Whether or not the message has been received or sent
          - `draft_mode` 'shared' | 'private', nullable — If the message is a draft, describes the draft mode. Can be 'private' (draft is visible to the author only) or 'shared' (draft is visible to all teammates with access to the conversation).
          - `error_type` string — Type of the error when the draft failed to be sent
          - `version` string — The current version of the message in Front
          - `created_at` number — The timestamp when the message was sent or received
          - `subject` string — Subject of the message
          - `blurb` string — Preview of the message body
          - `author` TeammateResponse — A teammate is a user in Front.
            - `_links` object, required
              - …
            - `id` string, required — Unique identifier of the teammate
            - `email` string, required — Email address of the teammate
            - `username` string, required — Username of the teammate (used for "@" mentions)
            - `first_name` string, required — First name of the teammate
            - `last_name` string, required — Last name of the teammate
            - `is_admin` boolean, required — Whether or not the teammate is an admin in your company
            - `is_available` boolean, required — Whether or not the teammate is available
            - `is_blocked` boolean, required — Whether or not the teammate account has been blocked
            - `type` 'user' | 'visitor' | 'ai' | 'api' | 'application' | 'bulk_reply' | 'csat' | 'integration' | 'macro' | 'rule' | 'smart_csat', required — Type of the teammate, normal teammates are denoted as "user", while visitors are denoted as "visitor". Bot users are denoted by their parent resource type. The following bot types are available: * ai: acting on behalf of an AI * api: acting on behalf of OAuth clients * application: acting on behalf of an Application * bulk_reply: acting on behalf of a Bulk Reply * csat: used for authoring CSAT response comments * integration: acting on behalf of an Integration * macro: acting on behalf of a Macro, author of comments and drafts * rule: acting on behalf of a Rule, author of comments and drafts * smart_csat: acting on behalf of a Smart CSAT
            - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
          - `recipients` RecipientResponse[]
            - `_links` object, required
              - …
            - `name` string, nullable, required — Name of the recipient.
            - `handle` string, required — Handle of the contact. Can be any string used to uniquely identify the contact
            - `role` 'from' | 'to' | 'cc' | 'bcc' | 'reply-to', required — Role of the recipient
          - `body` string — Body of the message
          - `text` string — Text version of the body for email messages
          - `attachments` Attachment[] — List of files attached to the message
            - `id` string, required — The unique identifier of the attachment.
            - `filename` string, required — Name of the attached file
            - `url` string, required — URL to download the attached file
            - `content_type` string, required — Content type of the attached file in [MIME format](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types). Note that some attachments types may not be supported.
            - `size` integer, required — Size (in byte) of the attached file
            - `metadata` object, required — Attachment metadata
              - …
          - `signature` SignatureResponse
            - `_links` object, required
              - …
            - `id` string, required — Unique identifier of the signature
            - `name` string, nullable, required — Name of the signature
            - `body` string, required — Body of the signature
            - `sender_info` string, nullable, required — Sender info of the signature
            - `is_visible_for_all_teammate_channels` boolean, required — Whether or not the signature is available in teammate channels.
            - `is_default` boolean, required — Whether the signature is the default signature for the team or teammate.
            - `is_private` boolean, required — Whether the signature is private to the teammate.
            - `channel_ids` string[], nullable, required
          - `metadata` object — Optional metadata about the message
            - `intercom_url` string — For `intercom` messages only. URL of the Intercom conversation the message is coming from.
            - `duration` integer — For `truly-call` messages only. Length of the call in seconds.
            - `have_been_answered` boolean — For `truly-call` messages only. Whether or not the call have been answered.
            - `external_id` string — For `tweet` or 'custom' (partner channel token authenticated) messages only. Unique message identifier in the underlying provider (Twitter or Partner). For custom messages, only present for partner channel token authenticated requests.
            - `twitter_url` string — For `tweet` messages only. URL of the tweet.
            - `is_retweet` boolean — For `tweet` messages only. Whether or not the tweet is a retweet.
            - `have_been_retweeted` boolean — For `tweet` messages only. Whether or not the tweet have been retweeted.
            - `have_been_favorited` boolean — For `tweet` messages only. Whether or not the tweet have been favorited.
            - `thread_ref` string — For `custom` messages only. Custom reference which is used to thread messages.
            - `headers` object — For `custom` messages only. Custom object holding internal information.
            - `chat_visitor_url` string — For `front_chat` messages only. Source URL from the chat widget when sending a message.
        - LinkResponse — A link used to connect a Front conversation to an external resource.
          - `_links` object, required
            - `self` string — Link to resource
          - `id` string, required — Unique identifier of the link
          - `name` string, required — Display name of the link
          - `type` string, required — Type of the link. Typically associated with the underlying link provider (if known)
          - `external_url` string, required — Underlying identifying external URL of the link
          - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
    - `conversation` ConversationResponse
      - `_links` object, required
        - `self` string — Link to resource
        - `related` object
          - `events` string — Link to conversation events
          - `followers` string — Link to conversation followers
          - `messages` string — Link to conversation messages
          - `comments` string — Link to conversation comments
          - `inboxes` string — Link to conversation inboxes
          - `last_message` string — Link to last message of the conversation
      - `id` string, required — Unique identifier of the conversation
      - `type` 'conversation' | 'discussion' | 'task', required — Type of the conversation
      - `subject` string, required — Subject of the message for email message
      - `status` 'archived' | 'unassigned' | 'deleted' | 'assigned', required — Status of the conversation
      - `status_id` string — Unique identifier of the conversation status category, only present if ticketing is enabled
      - `status_category` 'open' | 'waiting' | 'resolved' — Status category of the conversation
      - `ticket_ids` string[], required — List of ticket ids associated with the conversation
      - `assignee` TeammateResponse, required — A teammate is a user in Front.
        - `_links` object, required
          - `self` string — Link to resource
          - `related` object
            - `inboxes` string — Link to teammate's inboxes
            - `conversations` string — Link to teammate's conversations
            - `botSource` string — Link to the source resource of the bot (e.g. rule)
        - `id` string, required — Unique identifier of the teammate
        - `email` string, required — Email address of the teammate
        - `username` string, required — Username of the teammate (used for "@" mentions)
        - `first_name` string, required — First name of the teammate
        - `last_name` string, required — Last name of the teammate
        - `is_admin` boolean, required — Whether or not the teammate is an admin in your company
        - `is_available` boolean, required — Whether or not the teammate is available
        - `is_blocked` boolean, required — Whether or not the teammate account has been blocked
        - `type` 'user' | 'visitor' | 'ai' | 'api' | 'application' | 'bulk_reply' | 'csat' | 'integration' | 'macro' | 'rule' | 'smart_csat', required — Type of the teammate, normal teammates are denoted as "user", while visitors are denoted as "visitor". Bot users are denoted by their parent resource type. The following bot types are available: * ai: acting on behalf of an AI * api: acting on behalf of OAuth clients * application: acting on behalf of an Application * bulk_reply: acting on behalf of a Bulk Reply * csat: used for authoring CSAT response comments * integration: acting on behalf of an Integration * macro: acting on behalf of a Macro, author of comments and drafts * rule: acting on behalf of a Rule, author of comments and drafts * smart_csat: acting on behalf of a Smart CSAT
        - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
      - `recipient` RecipientResponse, required
        - `_links` object, required
          - `related` object
            - `contact` string, nullable — Link to recipient contact
        - `name` string, nullable, required — Name of the recipient.
        - `handle` string, required — Handle of the contact. Can be any string used to uniquely identify the contact
        - `role` 'from' | 'to' | 'cc' | 'bcc' | 'reply-to', required — Role of the recipient
      - `tags` TagResponse[], required — List of the tags for this conversation
        - `_links` object, required
          - `self` string — Link to resource
          - `related` object
            - `conversations` string — Link to tag conversations
            - `owner` string, nullable — Link to tag owner
            - `parent_tag` string, nullable — Link to parent tag
            - `children` string, nullable — Link to tag children
        - `id` string, required — Unique identifier of the tag
        - `name` string, required — Name of the tag
        - `description` string, nullable, required — Description of the tag
        - `highlight` string, nullable, required — Highlight color or emoji of the tag. Null if the tag does not have a highlight.
        - `is_private` boolean, required — Whether or not the tag is individual
        - `is_visible_in_conversation_lists` boolean, required — Whether the tag is visible in conversation lists.
        - `created_at` number — Timestamp of tag create creation
        - `updated_at` number — Timestamp of the last tag update
      - `links` LinkResponse[], required — List of the links for this conversation
        - `_links` object, required
          - `self` string — Link to resource
        - `id` string, required — Unique identifier of the link
        - `name` string, required — Display name of the link
        - `type` string, required — Type of the link. Typically associated with the underlying link provider (if known)
        - `external_url` string, required — Underlying identifying external URL of the link
        - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
      - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
      - `created_at` number — Timestamp at which the conversation was created.
      - `updated_at` number — Timestamp at which the conversation was last updated.
      - `waiting_since` number — Timestamp of the oldest unreplied message.
      - `is_private` boolean, required — Whether or not the conversation is private
      - `scheduled_reminders` Reminder[], required — List of scheduled (non-expired and non-canceled) reminders for this conversation
        - `_links` object, required
          - `related` object
            - `owner` string — Link to conversation owner
        - `created_at` number — Timestamp at which the conversation reminder has been created
        - `scheduled_at` number — Timestamp that the conversation reminder has been scheduled for
        - `updated_at` number — Timestamp at which the conversation reminder has been updated
      - `description` string, nullable — Description of the task. Only present on task conversations.
      - `due_at` number, nullable — Unix timestamp in seconds when the task is due. Only present on task conversations.
      - `metadata` object, required — Optional metadata about the conversation
        - `external_conversation_ids` string[] — List of external_ids for partner channel associated with the conversation. Only present for partner channel token authenticated requests.

## Other responses

- `301` — If the conversation has been merged, the response redirects you to the merged conversation.

---

[API](https://skmtc.net/frontapp/apis/core-api.md) · [All operations](https://skmtc.net/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)