Google Calendar URL Generation

From docs
Revision as of 14:59, 21 July 2026 by Ashley DeBon (talk | contribs) (Created page with "== Generate Google Calendar Sync URL == === Base URL === https://apimobile.callproof.com === Endpoint === /api/calendar/google-login/ === Purpose === Generates a Google OAu...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Generate Google Calendar Sync URL

Base URL

https://apimobile.callproof.com

Endpoint

/api/calendar/google-login/

Purpose

Generates a Google OAuth authorization URL used to start Google Calendar sync for the mobile app. The client credentials used depend on the requesting device type (Android or iOS).

HTTP Method

GET

Headers

None required.

Security

  • No – This endpoint is publicly accessible (does not require Bearer Token authentication).

Parameters

Path Parameters

None.

Query Parameters

Parameter Type Required Description
device string No Device type. Use android for Android client credentials; any other/omitted value uses iOS client credentials

Request Body

None.

Successful Response (200)

Returns the Google OAuth authorization URL.

Note: This endpoint returns a simple JSON object (not the standard authenticated API wrapper with clientStatusCode / user_id / company_id).

Field Type Description
url string Google OAuth authorization URL to open for calendar sync consent

Error Responses

Status Code Meaning
200 On failure, the response body may contain a JSON-encoded error message string instead of a url object
  • If URL generation fails, the response may be a JSON-encoded error message from the calendar service.