Attach a contact
Example Single User Request & Response
$ curl https://api.intercom.io/contacts/<id>/tags \\\n-X POST \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept:application/json' -d\n\n{\n\t\"id\": \"2084335\"\n}
Example Errors
HTTP/1.1 404 NOT FOUND\n{\n \"type\": \"error.list\",\n \"request_id\": \"9a3d0816-9707-4598-977e-c009ba630148\",\n \"errors\": [\n {\n \"code\": \"not_found\",\n \"message\": \"Contact Not Found\"\n }\n ]\n}
You can tag a single contact.
Request Path Parameter
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | String | Yes | The unique identifier for the contact which is given by Intercom |
Request Body Parameter
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | String | Yes | The unique identifier for the tag which is given by Intercom |
You can also tag multiple users
Multiple Request Body Parameter
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | String | Yes | The name of the tag, which will be created if not found. |
| users | Object | Yes | An array of objects with the unique identifier of the users to be tagged. |
Example Multi User Request & Response
$ curl https://api.intercom.io/tags \\\n-X POST \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept:application/json' -d\n{\n \"name\": \"Independent\",\n \"users\": [\n {\n \"id\": \"56cde0cc3deab1bd8c000100\"\n },\n {\n \"id\": \"63ced1cc3deab1bd8c11011\"\n }\n ]\n }
Response
This will return a Tag model for the tag that was added to the contact.