View source for Nearest Places Add to CallProof Contacts

== [[Mobile_API]] &#187;Add Place Contact ==

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

=== Endpoint ===
/api/place-contact

=== Purpose ===
Creates CallProof contact(s) from Google Places / Places search results. Accepts one or more place IDs. For a single place, returns the created (or existing) contact ID. For multiple places (lasso selection), returns a result list for each place indicating whether it was newly created or already existed.

=== HTTP Method ===
POST

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

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

=== Parameters ===

==== Path Parameters ====
None.

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

==== Request Body ====
{| class="wikitable"
! Parameter !! Type !! Required !! Description
|-
| place_id || string (JSON array) || Yes || JSON array of place ID(s) to convert into contacts (for example, <code>["ChIJ..."]</code> or multiple IDs for lasso)
|-
| name || string || Yes || Place/display name
|-
| latitude || string/number || Yes || Place latitude
|-
| longitude || string/number || Yes || Place longitude
|}

=== cURL Example for Android ===

<pre> curl --location 'https://apimobile.callproof.com/api/place-contact' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "place_id": ["YOUR_PLACE_ID"], "name": "YOUR_PLACE_NAME", "latitude": "YOUR_LATITUDE", "longitude": "YOUR_LONGITUDE" }' </pre>

=== cURL Example for iOS ===

<pre> curl --location 'https://apimobile.callproof.com/api/place-contact' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "place_id": ["YOUR_PLACE_ID"], "name": "YOUR_PLACE_NAME", "latitude": "YOUR_LATITUDE", "longitude": "YOUR_LONGITUDE" }' </pre>

=== Successful Response (200) ===

==== Single place ====
Used when one place ID is submitted.

{| 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, "New accounts added." or "Account added successfully" when the place already exists as a contact)
|-
| contact_id || integer || Identifier of the created or existing contact
|-
| uri || string || Requested resource URI
|}

==== Multiple places (lasso) ====
Used when more than one place ID is submitted.

{| 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, "New accounts added.")
|-
| data || array || Per-place results (see below)
|-
| uri || string || Requested resource URI
|}

==== data[] (lasso) ====
{| class="wikitable"
! Field !! Type !! Description
|-
| place_id || string || Place identifier that was processed
|-
| contact_id || integer || Contact identifier created or already linked to the place
|-
| is_exists || boolean || <code>true</code> if the place was already a contact; <code>false</code> if newly created
|}

=== Error Responses ===
{| class="wikitable"
! Status Code !! Meaning
|-
| 200 || Validation failed – response body uses <code>clientStatusCode</code> 401 with the first validation error message
|-
| 400 || Bad Request – place contact(s) could not be created
|-
| 401 || Unauthorized – missing, invalid, or expired Bearer token
|}

* '''Validation (HTTP 200, clientStatusCode 401)''' – Missing <code>place_id</code>, <code>name</code>, <code>latitude</code>, or <code>longitude</code>.
* '''400''' – Place data not found, or another create error (for example, "Error While Adding PlaceContact").
* '''401''' – Authentication failed or the access token is missing/expired.