Google Workspace Integration

Automate your on-call status in Calendar and sync distribution lists with your teams

1. Create or sign into your Google Workspace account

2. Authorize a service account for Hyphen to your Google Workspace

  • In the Admin console, go to Menu > Security > Access and data control > API controls > Manage Domain Wide Delegation.

You must be signed in as a super administrator for this task.

  • Click Add new.

  • Enter the service account ID for either the service account or the OAuth2 client.

  • In OAuth Scopes, add the following OAuth scopes and click Authorize.

    https://www.googleapis.com/auth/admin.directory.group,
    https://www.googleapis.com/auth/admin.directory.group.member,
    https://www.googleapis.com/auth/admin.directory.user.alias.readonly,
    https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly,
    https://www.googleapis.com/auth/admin.directory.group.member.readonly,
    https://www.googleapis.com/auth/admin.directory.group.readonly,
    https://www.googleapis.com/auth/admin.directory.user.readonly,
    https://www.googleapis.com/auth/admin.directory.domain.readonly,
    https://www.googleapis.com/auth/admin.reports.audit.readonly,
    https://www.googleapis.com/auth/apps.groups.settings
    
  • Point to the new client ID, click View details, and make sure that every scope is listed. If a scope is not listed, click Edit, enter the missing scope, and click Authorize. You can't edit the client ID.

More detailed information can be found at the Google Workspace documentation for Setting up domain-wide delegation for a client.
Changes can take up to 24 hours but typically happen more quickly.

3. Connect Workspace

Enter your workspace domain and admin user email to connect your Google Workspace account to Hyphen.