Assign a conversation

Example Request & Response (Assigning to Admin)

curl
json

$ curl https://api.intercom.io/conversations/{id}/parts \\-X POST \\-H 'Authorization:Bearer <Your access token>' \\-H 'Accept:application/json' \\-H 'Content-Type:application/json' -d{  \"type\": \"admin\",  \"admin_id\": \"814860\",  \"assignee_id\": \"530165\",  \"message_type\": \"assignment\",  \"body\": \"Reassigning for X reason.\",}

Example Request & Response (Auto Assignment)

curl
http

$ curl 'https://api.intercom.io/conversations/{id}/run_assignment_rules'-X POST -H 'Authorization: Bearer <Your access token>' -H 'Accept: application/json' -H 'Content-Type: application/json'

You can assign a conversation to an admin and/or team. You can also let it be automatically assigned following assignment rules.

Request Path Parameters

Parameter	Required?	Description
id	Yes	The identifier for the conversation as given by Intercom.
run_assignment_rules	No	Runs through all assignment rules created in the Intercom Inbox product for a given workspace.

Request Body Parameters

No body parameters are required when auto assigning conversations using the {id}/run_assignment_rules path parameter.

Argument	Type	Required?	Description
message_type	String	Yes	Always `assignment`.
type	String	Yes	Accepts `admin` or `team`.
admin_id	String	Yes	The `id` of the admin who is performing the action.
assignee_id	String	Yes	The `id` of the admin or team which will be assigned the conversation. A conversation can be assigned both an admin and a team. Set `0` if you want this assign to no admin or team (ie. Unassigned).
body	String	No	Optionally you can leave a note in the conversation for additional context to other teammates.

Response