Skip to content
Home/
REST API Reference
/
/
Conversation source

Conversation source

The first message or event that started this conversation. Describes the origin and who initiated it.

typestring

The origin of this conversation.

Example:"email"
idstring or null

The id of the source message.

Example:"3"
delivered_asstring

How the conversation was initiated.

Example:"operator_initiated"
recipientsArray of objects or null

The recipients of the source message. Only present for email conversations.

reply_toArray of objects or null

The Reply-To header addresses of the source message, where a reply will be routed. Can differ from the sender's From address. Only present for email conversations.

subjectstring or null

The message subject. Only present for email conversations.

Example:""
bodystring or null

The message body, which may contain HTML.

Example:"<p>Hey there!</p>"
authorobject(Conversation source author)

The author who started the conversation. Can be a Contact, Admin, or Bot.

attachmentsArray of objects(Part attachment)

A list of attachments on the source message.

urlstring or null

The URL where the conversation was started.

Example:"https://intercom.help/company/article/123"
redactedboolean

Whether or not the source content has been redacted.

Example:false
email_message_metadataobject(Email Message Metadata)

Contains metadata if the message was sent as an email

{
  "type": "email",
  "id": "3",
  "delivered_as": "operator_initiated",
  "recipients": [
    { … }
  ],
  "reply_to": [
    { … }
  ],
  "subject": "",
  "body": "<p>Hey there!</p>",
  "author": {
    "type": "admin",
    "id": "274",
    "name": "Jane Doe",
    "email": "jane.doe@example.com"
  },
  "attachments": [
    { … }
  ],
  "url": "https://intercom.help/company/article/123",
  "redacted": false,
  "email_message_metadata": {
    "message_id": "<CADKw7xrXzqSn8v3mP8K8Q8yZ6K8Q8yZ6@mail.gmail.com>",
    "subject": "Question about my order",
    "email_address_headers": [ … ],
    "history": "<div><span>On Jan 28, wrote:</span><blockquote>Previous thread</blockquote></div>"
  }
}