Save User Location Details

From docs
Revision as of 07:43, 17 July 2026 by Ashley DeBon (talk | contribs) (Created page with "== Store Contact Location Log == === Base URL === https://apimobile.callproof.com === Endpoint === /api/contact/location-log === Purpose === Saves the authenticated user’...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Store Contact Location Log

Base URL

https://apimobile.callproof.com

Endpoint

/api/contact/location-log

Purpose

Saves the authenticated user’s current geographic location. The latitude and longitude are stored as a location log entry and enriched with reverse-geocoded address details when available, so the system can track where the user was at the time of the log.

HTTP Method

POST

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
latitude string Yes Latitude of the user’s current location
longitude string Yes Longitude of the user’s current location
geo_track_type string Yes Location tracking type associated with the log entry
link_id integer No Related record identifier to associate with the location log, when applicable

Successful Response (200)

Indicates that the location log was stored 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, "Success")
uri string Requested resource URI

Error Responses

Status Code Meaning
400 Bad Request – the location log could not be stored successfully
401 Unauthorized – missing, invalid, or expired Bearer token
  • 400 – An error occurred while saving the location log or resolving address details for the coordinates.
  • 401 – Authentication failed or the access token is missing/expired.