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

2026-07-20T15:25:44Z

‎Successful Response (200)

Ashley DeBon: /* Store New Call */

2026-07-20T15:24:26Z

‎Store New Call

Ashley DeBon: Created page with "== Store New Call == === Base URL === https://apimobile.callproof.com === Endpoint === /api/new-call === Purpose === Logs a new phone call for the authenticated user. Creat..."

2026-07-20T15:23:57Z

Created page with "== Store New Call == === Base URL === https://apimobile.callproof.com === Endpoint === /api/new-call === Purpose === Logs a new phone call for the authenticated user. Creat..."

New page

== Store New Call ==

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

=== Endpoint ===
/api/new-call

=== Purpose ===
Logs a new phone call for the authenticated user. Creates a call record when none exists for the same details, or updates duration when a matching call already exists. Incoming calls from iOS devices are ignored. Optionally clears a related follow-up recommendation when the call is logged from a recommended follow-up action.

=== 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
|-
| phone_number || string || Yes || Phone number for the call (digits only after processing; minimum 7 characters; letters are not allowed)
|-
| call_date || integer || Yes || Call start time as a Unix timestamp (milliseconds)
|-
| call_duration || integer || No || Call duration in seconds (defaults to 0 when omitted)
|-
| call_type || string || No || Call direction/type (for example, <code>incoming</code>, <code>outgoing</code>, <code>unknown</code>)
|-
| call_id || integer || No || Local device call identifier (defaults to 0 when omitted)
|-
| contact_id || integer || No || Contact to associate with the call
|-
| device_type || string || No || Device type that logged the call (for example, iOS). Incoming iOS calls are rejected
|-
| recommended_followup || integer || No || When set to <code>1</code> and <code>contact_id</code> is provided, removes the related call follow-up recommendation for that contact
|}

=== Successful Response (200) ===
Indicates that the call was logged (or an existing matching call 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, "Call Details Added Successfully")
|-
| uri || string || Requested resource URI
|}

=== 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 – the call could not be logged
|-
| 401 || Unauthorized – missing, invalid, or expired Bearer token
|}

* '''Validation (HTTP 200, clientStatusCode 401)''' – Missing/invalid <code>phone_number</code>, missing/invalid <code>call_date</code>, or invalid <code>call_duration</code>.
* '''400''' – Incoming iOS call ignored, call could not be added/updated (for example, "Error while Adding New Call Details" / "Error While Adding New Call Details").
* '''401''' – Authentication failed or the access token is missing/expired.

← Older revision		Revision as of 15:24, 20 July 2026
Line 1:		Line 1:
−	== Store New Call ==	+	== [[Mobile_API]] »Store New Call ==

	=== Base URL ===		=== Base URL ===

@@ Line 51: / Line 51: @@
 | recommended_followup || integer || No || When set to <code>1</code> and <code>contact_id</code> is provided, removes the related call follow-up recommendation for that contact
 |}
 === Successful Response (200) ===

New Call - Revision history

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

Ashley DeBon: /* Store New Call */

Ashley DeBon: Created page with "== Store New Call == === Base URL === https://apimobile.callproof.com === Endpoint === /api/new-call === Purpose === Logs a new phone call for the authenticated user. Creat..."