Skip to content

Configuring the Google Integration

How to register the app in Google Cloud, obtain OAuth2 credentials, and verify that jobs are scheduled correctly.

1) Project and APIs in Google Cloud

  1. Open Google Cloud Console and create a New Project.
  2. In API & Services → Library enable:
  3. Google Calendar API
  4. Google People API (contacts)
  5. Gmail API (if mail is used)
  1. In OAuth consent screen choose the user type (Internal for corporate domain, otherwise External).
  2. Fill in the app name and contact email.
  3. In Scopes add the permissions that match the integration: calendar, contacts/people, gmail.

3) OAuth Client ID

  1. In Credentials click Create Credentials → OAuth client ID.
  2. Choose Web application.
  3. In Authorized redirect URIs paste your CRM URL + the callback shown in CRM (Integrations → Google → Redirect URI).
  4. Example: https://crm.yourcompany.com/api/v1/Google/redirect
  5. Note the Client ID and Client Secret values.

4) Configure AutoCRM

  1. Go to Admin → Integrations → Google.
  2. Enter clientId and clientSecret. Other parameters (endpoints, scopes) are prefilled from integrations/Google.json.
  3. Save. CRM then shows the Redirect URI – share it with users.

5) Verify jobs

  • In Admin → Scheduled Jobs check that GoogleJob (daily 02:15) and SynchronizeEventsWithGoogleCalendar (*/10 min, Active) exist.
  • If a job is missing, rerun the module install script or create it manually with the same name/class.

Operational tips

  • For Google Workspace, publish the app (Production) and, if needed, domain-approve it.
  • When rotating clientSecret, update it in CRM as well – users can reconnect without further changes.