Assign a conversation to an account or a team

Reassigns an existing conversation. The new assignee is notified as when assigning from the Customerly inbox,
and an assignment message is added to the conversation.

  • A closed or snoozed conversation is reopened by the assignment (the message type is then assignment_open)
  • Assigning the conversation to its current assignee changes nothing
  • A conversation cannot be assigned to AI (Aura)
  • A running chatflow on the conversation is stopped

Request Fields

Required fields

  • assignee_type (string): Type of the new assignee. One of account, team.
  • assignee_id (integer): ID of the account or team to assign the conversation to.

Optional fields

  • account_id (integer): The account performing the assignment, recorded as the author of the assignment
    message in the Customerly inbox. Defaults to the account owning the access token.

Examples

Assign to an account

{ "assignee_type": "account", "assignee_id": 456 }

Assign to a team on behalf of another account

{ "assignee_type": "team", "assignee_id": 789, "account_id": 123 }
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
\d+

The conversation id

Body Params
string
enum
required

Type of the new assignee

Allowed:
integer
required

ID of the account or team to assign the conversation to

integer | null

The account performing the assignment, recorded as the author of the assignment message. Defaults to the account owning the access token.

Responses

401

Authentication required

403

Permission denied or conversation access denied

404

Conversation, account or team not found

409

Conversation is frozen

422

Validation failed or assignee is AI

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json