Move the Personnel to Another Contact
Contents
Move Contact Personnel
Base URL
https://apimobile.callproof.com
Endpoint
/api/contact/move-personnel
Purpose
Moves an existing person from their current contact to another contact. The person is associated with the destination contact, related phone and follow-up information is updated accordingly, and the original personnel record is marked as moved/disabled.
HTTP Method
PUT
Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer access token |
Security
- Yes – Requires Bearer Token authentication.
Parameters
Path Parameters
None.
Query Parameters
None.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| personnel_id | integer | Yes | Unique identifier of the person to move |
| contact_id | integer | Yes | Unique identifier of the destination contact / account that will receive the person |
cURL Example for Android
curl --location --request PUT 'https://apimobile.callproof.com/api/contact/move-personnel' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --form 'personnel_id=6789' \ --form 'contact_id=12345'
cURL Example for iOS
curl --location --request PUT 'https://apimobile.callproof.com/api/contact/move-personnel' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --form 'personnel_id=6789' \ --form 'contact_id=12345'
Successful Response (200)
Indicates that the person was moved to the destination contact successfully.
| Field | Type | Description |
|---|---|---|
| clientStatusCode | integer | Status indicator for the client (for example, 200) |
| user_id | integer | Identifier of the authenticated user |
| company_id | integer | Identifier of the authenticated user’s company |
| message | string | Confirmation message (for example, "Contact was moved to another company.") |
| uri | string | Requested resource URI |
Error Responses
| Status Code | Meaning |
|---|---|
| 400 | Bad Request – the person could not be moved |
| 401 | Unauthorized – missing, invalid, or expired Bearer token |
- 400 – The destination contact was not found, the personnel ID is invalid, the personnel record was not found, or another error occurred while moving the person (for example, "Error while Personnel moved to another contact").
- 401 – Authentication failed or the access token is missing/expired.
