Adding a customer to a group conversation
Customers
Note that customers refers to both users and leads.
$ curl 'https://api.intercom.io/conversations/11055118659/customers' \
-X POST \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json' \
-H 'Content-Type:application/json' -d'
{
"admin_id": "781236",
"customer":{
"intercom_user_id": "58c1c78946a0aa9ef45b098a"
}
}'
HTTP/1.1 200 OK
{"customers":[
{"type":"user","id":"597f02cb22f4bb37597e0b7d"},
{"type":"lead","id":"58ff3f670f14ab4f1aa83750"}]
}
Customers can be added to a conversation via a POST method to https://api.intercom.io/conversations/{convo_id}/customers/, which accepts a JSON object describing the customer.
Arguments
| Argument | Required | Description |
|---|---|---|
| admin_id | Yes | You must provide the ID of a valid admin to add a customer to the conversation |
| customer | Yes | JSON object describing the customer that you want to add to the conversation. |
Customer object
| Argument | Required | Description |
|---|---|---|
| intercom_user_id | one of | The Intercom defined id representing the user (in the URL) |
| user_id | one of | The user id you have defined for the user (or auto defined in the case of leads) |
| one of | The email you have defined for the user |
Note about customers without an email
If you try to add a customer via intercom_user_id or user_id which does not have an email you will receive an error. Alternatively, If you add a customer via the email parameter and there is no user/lead in the system for that customer then we will create a new lead.