curl --request POST \
--url https://{projectID}.texterchat.com/server/api/v2/chats/assign \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'"OK"{
"error": "User with CRM ID Texter Agent not found"
}{
"error": "Chat not found for phone: 0529998877"
}Assign Chat
Assign a specific chat to a designated agent and/or department. When a chat is assigned, its status is automatically set to PENDING for that agent and/or department.
curl --request POST \
--url https://{projectID}.texterchat.com/server/api/v2/chats/assign \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'"OK"{
"error": "User with CRM ID Texter Agent not found"
}{
"error": "Chat not found for phone: 0529998877"
}Manage all chats
Identify the chat with phone or chatId (if both are sent, phone is used and chatId is ignored; omitting both is an error), and the assignee with exactly one agent identifier (agentUid / agentEmail / agentCrmId), a departmentId, or a department plus one agent identifier. A malformed chatId returns 400 Invalid chatId. Unrecognized body fields are rejected with 400.Authorizations
API token generated in Texter: gear icon → Developers → API Tokens. When creating a token, assign it the scopes required by the endpoints you plan to call - each endpoint lists its required scopes.
Body
The contact's phone number (any common format - normalized automatically). Provide either phone or chatId
The unique identifier of the chat to assign. Provide either chatId or phone
The internal user ID of the agent in Texter. Only one agent identifier can be used
The agent's email address in Texter. Only one agent identifier can be used
The agent's CRM identifier in Texter. Only one agent identifier can be used
The department ID to assign the chat to. Use a department ID string alone or together with a single agent identifier. null is only meaningful together with an agent identifier (assigns the agent and clears the department); sending departmentId: null alone is an error
Required only when multiple chats exist for the same phone number, to disambiguate
Show child attributes
Show child attributes
Response
Chat assigned. Body is the plain text OK