Skip to main content
POST
/
v1
/
conversations
/
transfer
Transfer a conversation to another inbox
curl --request POST \
  --url https://api.heymarket.com/v1/conversations/transfer \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation_id": 123,
  "transfer_inbox_id": 123
}
'
Use this endpoint to move a conversation from one inbox to another. This is useful when a conversation needs to be handled by a different team or phone number. The endpoint returns "ok" on success.

​
Request body

​
conversation_id
integer
required
The ID of the conversation to transfer.
​
transfer_inbox_id
integer
required
The ID of the inbox to transfer the conversation to.

​
Response

Returns the string "ok" on success.

​
Request example

{
  "conversation_id": 1,
  "transfer_inbox_id": 2
}

​
Example

curl --request POST \
  --url https://api.heymarket.com/v1/conversations/transfer \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "conversation_id": 9920,
    "transfer_inbox_id": 305
  }'
Conversations cannot be transferred to an inbox where the conversation already exists.
Only SMS conversations are currently supported for transfer. Email and other channel types are not eligible.