Update the Contact - Revision history

Ashley DeBon: /* cURL Example for Android */

2026-07-16T13:02:03Z

‎cURL Example for Android

Ashley DeBon: /* Successful Response (200) */

2026-07-16T12:52:17Z

‎Successful Response (200)

Ashley DeBon: Created page with "== Update Contact == === Base URL === https://apimobile.callproof.com === Endpoint === /api/contacts/{id} === Purpose === Updates an existing contact’s account and profil..."

2026-07-16T12:51:38Z

Created page with "== Update Contact == === Base URL === https://apimobile.callproof.com === Endpoint === /api/contacts/{id} === Purpose === Updates an existing contact’s account and profil..."

New page

== Update Contact ==

=== Base URL ===
https://apimobile.callproof.com

=== Endpoint ===
/api/contacts/{id}

=== Purpose ===
Updates an existing contact’s account and profile information, including company details, address, phone, email, website, and optional custom fields. When the address changes, location coordinates may be reset so the contact can be re-mapped. A successful update also records a contact update activity for the account.

=== HTTP Method ===
PUT

=== Headers ===
{| class="wikitable"
! Header !! Required !! Description
|-
| Authorization || Yes || Bearer access token
|}

=== Security ===
* '''Yes''' – Requires Bearer Token authentication.

=== Parameters ===

==== Path Parameters ====
{| class="wikitable"
! Parameter !! Type !! Required !! Description
|-
| id || integer || Yes || Unique identifier of the contact to update
|}

==== Query Parameters ====
None.

==== Request Body ====
{| class="wikitable"
! Parameter !! Type !! Required !! Description
|-
| company_name || string || Yes || Company / account name
|-
| account_type_id || integer || Yes || Contact / account type identifier
|-
| account_number || number / string || No || Account number
|-
| parent_company || string || No || Parent company / title
|-
| address || string || No || Primary street address (maximum 80 characters)
|-
| address2 || string || No || Secondary street address (maximum 80 characters)
|-
| city || string || No || City
|-
| state_id || integer || No || State identifier
|-
| zipcode || string || No || Postal / ZIP code
|-
| country_id || integer || No || Country identifier
|-
| company_email || string || No || Company email address
|-
| phone || string || No || Primary phone number (7–15 digits). When provided, phone type becomes required
|-
| extension || string || No || Phone extension
|-
| phone_type_id || integer || No || Phone type identifier. Required when <code>phone</code> is provided
|-
| country_code || string || No || Country calling code for the phone number
|-
| website || string || No || Website URL
|-
| notes || string || No || Notes associated with the contact update
|-
| contact_company_id || integer || No || Contact company identifier
|-
| custom_fields || string || No || JSON string containing custom field values to update
|}

=== Successful Response (200) ===
Indicates that the contact was updated successfully.

{| class="wikitable"
! 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, "The account info has been updated.")
|-
| uri || string || Requested resource URI
|}

=== Error Responses ===
{| class="wikitable"
! Status Code !! Meaning
|-
| 200 || Validation failure – request body failed validation (returned with an error payload and <code>clientStatusCode</code> 401)
|-
| 400 || Bad Request – the contact could not be updated (for example, invalid account type or update processing error)
|-
| 401 || Unauthorized – missing, invalid, or expired Bearer token
|}

* '''200 (validation failure)''' – Required fields are missing or invalid (for example, missing company name, missing account type, invalid phone format, or missing phone type when a phone number is provided).
* '''400''' – The contact update failed, such as when the account type is not found or an error occurs while saving contact or phone details.
* '''401''' – Authentication failed or the access token is missing/expired.

@@ Line 85: / Line 85: @@
 --form 'account_type_id=1'
 </pre>
 === cURL Example for iOS ===
 <pre>

@@ Line 77: / Line 77: @@
 | custom_fields || string || No || JSON string containing custom field values to update
 |}
 === Successful Response (200) ===