Assign Contact to an Agent

POST

https://api.mottasl.ai/v1/contact/assign

Last modified:2026-03-02 00:18:36

Assign a Contact to an Agent

Use this endpoint to assign a specific contact to an Agent inside your Business.
The contact is identified using platform_id (the contact’s phone number), and the assignee is identified using assigned_platform_id (the Agent ID).

This endpoint can be used to:

Route a contact to a specific Agent 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.

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": "966544444444",
    "assigned_platform_id": "omar@twerlo.com"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.mottasl.ai/v1/contact/assign' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "platform_id": "966544444444",
    "assigned_platform_id": "omar@twerlo.com"
}'

Responses

🟢200Success

application/json

Body

Example

{"message":"assignment completed successfully","success":true}

🔴500InternelError

🟠400BadRequest

Modified at 2026-03-02 00:18:36

Get an Agent Details

Create a Contact

Assign Contact to an Agent

Assign a Contact to an Agent#

Request

Request Code Samples

Responses

Assign a Contact to an Agent