Create Conversation Request Payload

REST API Reference

Conversations are how you can communicate with users in Intercom. They are created when a contact replies to an outbound message, or when one admin directly sends a message to a single contact.

fromobjectrequired

bodystringrequired

The content of the message. HTML is not supported.

Example:"Hello"

subjectstring

The title of the email. Only applicable if the message type is email.

Example:"Thanks for everything"

attachment_urlsArray of strings, (uri), <= 10 items

A list of image URLs that will be added as attachments. You can include up to 10 URLs.

created_atinteger, (date-time)

The time the conversation was created as a UTC Unix timestamp. If not provided, the current time will be used. This field is only recommneded for migrating past conversations from another source into Intercom.

Example:1671028894

brand_idstring

The unique identifier of the brand to associate with this conversation.

Example:"123"

{
  "from": {
    "type": "user",
    "id": "536e564f316c83104c000020"
  },
  "body": "Hello",
  "subject": "Thanks for everything",
  "attachment_urls": [
    "http://example.com"
  ],
  "created_at": 1671028894,
  "brand_id": "123"
}