Assign Contact to an Agent or Team

Use this endpoint to assign a specific contact to an Agent or a Team inside your Business.
The contact is identified by platform_id, and the assignee is identified by assigned_id. Use is_team to control whether the assignee is treated as a Team or an individual Agent.

This endpoint is typically used to:

Route a contact to a specific Agent or Team for ownership and follow-up.

Support manual assignment flows in Inbox / Contact Profile views.

Enable automation rules that assign contacts based on routing logic or user input.

💡

Both identifiers accept more than one format:

platform_id (the contact) — a phone number (e.g. 966544444444) or a contact ID (e.g. 8347).

assigned_id (the assignee) — a numeric agent/team ID (e.g. 324) or an email (e.g. omar@twerlo.com).

Set is_team to true to assign to a Team, or false (default) to assign to an individual Agent. IDs can be retrieved from their respective listing endpoints before calling this one.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Example

{
    "platform_id": "966566666666",
    "assigned_id": "omar@azeer.com",
    "is_team": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Assign Contact to an Agent or Team