API:ContactPhone:Update

API » Update Contact Phone

Base URL

https://app.callproof.com

Endpoint

/api/contact_phone/update/

Purpose

Updates an existing contact phone number in your CallProof company. Use this to change phone details such as number, type, extension, status flags, eligibility dates, dealer/store association, and related attributes for a known phone record.

HTTP Method

POST

Headers

Header	Required	Description
Content-Type	Yes	Must be application/json.

Security

• Yes – Requires a valid API key and secret with permission to update contact phones. Credentials are sent in the request body.

Parameters

Path Parameters

None.

Query Parameters

None.

Request Body

Parameter	Type	Required	Description
api_key	object	Yes	Authentication credentials object.
api_key.key	string	Yes	Public API key assigned to your CallProof account.
api_key.secret	string	Yes	Private API secret paired with the API key.
contact_phone	object	Yes	Contact phone update payload.
contact_phone.id	integer	Yes	Unique identifier of the phone record to update. Must belong to your company.
contact_phone.phone_number	string	No	Updated phone number digits. Leading country code 1 is normalized for 11-digit numbers.
contact_phone.phone_type	string	No	Phone type name (for example, Mobile or Office). Applied only when it matches a recognized phone type.
contact_phone.ext	string	No	Phone extension. Digits only; maximum 6 characters.
contact_phone.unknown	integer	No	Set to 1 to mark as unknown; otherwise 0. Defaults to not unknown when omitted.
contact_phone.hidden	integer	No	Set to 1 to hide the phone; otherwise 0. Defaults to not hidden when omitted.
contact_phone.do_not_call	integer	No	Set to 1 to enable do-not-call; otherwise 0. Defaults to not do-not-call when omitted.
contact_phone.last_contacted	datetime string	No	Date and time this phone was last contacted.
contact_phone.eligible	datetime string	No	Eligibility date/time.
contact_phone.activated	datetime string	No	Activation date/time.
contact_phone.dealer_store	string	No	Dealer/store name. Applied only when it matches an existing store in your company. Maximum 255 characters.
contact_phone.model	string	No	Model value. Maximum 255 characters.
contact_phone.call_result	string	No	Call result name. Applied only when it matches an existing call result in your company. Maximum 255 characters.

cURL Example

curl -X POST "https://app.callproof.com/api/contact_phone/update/" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": {
      "key": "YOUR_API_KEY",
      "secret": "YOUR_API_SECRET"
    },
    "contact_phone": {
      "id": 1001,
      "phone_number": "5551234567",
      "phone_type": "Mobile",
      "do_not_call": 0
    }
  }'

Successful Response (200)

Indicates the phone record was processed. On a successful update, the response returns the updated phone details.

Field	Type	Description
results	object	Contact phone details after processing.
results.id	integer	Unique identifier for the phone number.
results.last_contacted	string	Date and time this phone was last contacted.
results.unknown	integer	1 if marked unknown; otherwise 0.
results.do_not_call	integer	1 if do-not-call is enabled; otherwise 0.
results.contact_id	integer	Associated contact identifier.
results.contact	string	Contact display name.
results.phone_type	string	Phone type name.
results.phone_number	string	Phone number.
results.ext	string	Phone extension, if any.
results.activated	string	Activation date/time, if set.
results.eligible	string	Eligibility date/time, if set.
results.call_result	string	Last call result, if any.
results.hidden	integer	1 if the phone is hidden; otherwise 0.
results.dealer_store	string	Associated dealer/store name, if any.
results.model	string	Model value, if any.
results.updated	string	Date and time the phone record was last updated.
results.created	string	Date and time the phone record was created.
errors	array	Empty list when the request succeeds.
code	integer	HTTP-style status value; 200 on success.

Example response:

{
  "results": {
    "id": 1001,
    "last_contacted": "2024-06-15 14:30:00",
    "unknown": 0,
    "do_not_call": 0,
    "contact_id": 789,
    "contact": "John Doe",
    "phone_type": "Mobile",
    "phone_number": "5551234567",
    "ext": "",
    "activated": "",
    "eligible": "",
    "call_result": "",
    "hidden": 0,
    "dealer_store": "",
    "model": "",
    "updated": "2024-06-15 14:30:00",
    "created": "2024-01-10 09:00:00"
  },
  "errors": [],
  "code": 200
}

Notes

• The id parameter is the phone-record ID, not the contact ID.
• The phone record must belong to your company.
• If the updated phone number already exists on the same contact, the update is not applied.
• Phone numbers are normalized to digits. An 11-digit number starting with 1 is treated as a U.S./Canada number and reduced to 10 digits.
• phone_type, dealer_store, and call_result are applied only when they match existing values in your company.
• Boolean-style fields (unknown, hidden, do_not_call) default to 0/false when omitted.
• After a successful update, the phone record’s last-updated timestamp is refreshed.

Error Responses

Status Code	Meaning
400	Bad Request – The phone ID is missing, invalid, or does not match a phone record in your company.
401	Unauthorized – The API key and/or secret is missing, invalid, inactive, associated with a disabled account, or lacks permission to update contact phones.
405	Method Not Allowed – A method other than POST was used.
500	Internal Server Error – An unexpected server problem occurred. Not specified in Swagger.

400 response body example:

{
  "results": [],
  "errors": ["Invalid 'id' field"],
  "code": 400
}

401 response body example:

{
  "results": [],
  "errors": ["Invalid API Key"],
  "code": 401
}

405 response body example:

{
  "results": [],
  "errors": ["Method not allowed"],
  "code": 405
}