Skip to main content
POST
/
v1
/
conversations
/
reassign
Reassign a conversation to another user
curl --request POST \
  --url https://api.heymarket.com/v1/conversations/reassign \
  --header 'Content-Type: application/json' \
  --data '
{
  "inbox_id": 123,
  "target": "<string>",
  "targets": [
    "<string>"
  ],
  "user_id": 123,
  "reassign_id": 123
}
'
Use this endpoint to reassign a conversation from one team member to another within the same inbox. This is useful for routing conversations to the right agent or balancing workload across your team. The endpoint returns "ok" on success.

​
Request body

​
inbox_id
integer
required
The ID of the inbox containing the conversation.
​
target
string
The contact’s phone number in E.164 format without the leading plus sign (e.g., 14155551234). Required if targets is not provided.
​
targets
string[]
An array of phone numbers for group MMS conversations. Required if target is not provided.
​
user_id
integer
required
The ID of the user who currently owns the conversation.
​
reassign_id
integer
required
The ID of the user to reassign the conversation to.

​
Response

Returns the string "ok" on success.

​
Example

curl --request POST \
  --url https://api.heymarket.com/v1/conversations/reassign \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "inbox_id": 101,
    "target": "14155551234",
    "user_id": 55,
    "reassign_id": 72
  }'