INintercom
Conversations

Attach a contact to a conversation

Changed on

You can add participants who are contacts to a conversation, on behalf of either another contact or an admin.

{% admonition type="warning" name="Contacts without an email" %} If you add a contact via the email parameter and there is no user/lead found on that workspace with he given email, then we will create a new contact with role set to lead. {% /admonition %}

post/conversations/{conversation_id}/customers

Request

  • Base URL
    https://api.intercom.io
  • Auth
    HTTP bearer

Path parameters

conversation_idstring required

The identifier for the conversation as given by Intercom.

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

Intercom API version.</br>By default, it's equal to the version set in the app package.

Example:2.14

Request body

admin_idstring

The id of the admin who is adding the new participant.

Example request

{
  "admin_id": "12345",
  "customer": {
    "intercom_user_id": "6329bd9ffe4e2e91dac76188",
    "customer": {
      "intercom_user_id": "6329bd9ffe4e2e91dac76188"
    }
  }
}

Response

Attach a contact to a conversation

Example response

{
  "customers": [
    {
      "type": "user",
      "id": "6762f1a61bb69f9f2193bbd8"
    }
  ]
}

Changes

  • 2.141409a459eaafRevision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the required property to the response with the status

  • 2.14ca58987acfefRevision changes
    • breaking

      the response's property type changed from string to integer for status