Skip to main content
PUT
/
v3
/
contacts
/
owner
Change contacts owner
curl --request PUT \
  --url https://api.reply.io/v3/contacts/owner \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactIds": [
    123
  ],
  "userId": 123,
  "reassignTasks": false
}
'
{
  "isSuccess": true,
  "affectedIds": [
    123
  ]
}

Authorizations

​
Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Body

application/json
​
contactIds
integer[]
required

Array of contact IDs to reassign

​
userId
integer
required

Target user ID to assign as owner

​
reassignTasks
boolean
default:false

Whether to also reassign tasks associated with these contacts

Response

Owner changed successfully

​
isSuccess
boolean
​
affectedIds
integer[]

IDs of contacts whose owner was changed