<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/693b5665-ead3-448e-917a-c3783fe6a6f2/Google__G__Logo.svg.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/693b5665-ead3-448e-917a-c3783fe6a6f2/Google__G__Logo.svg.png" width="40px" /> If you’re not a Google Workspace Admin, please share this guide with your team’s GW Admin. They do not need access to Ashby, but you should input their email address here on the Google Workspace tile in the Integrations Marketplace.
</aside>
To get started with Ashby, we recommend setting up the Google Workspace Integration and setting up a shared Google Calendar. These will ensure streamlined candidate and interviewer communication from the beginning.
Section Overview:
Ashby integrates with Google Workspace to enable key features like displaying your conversations with candidates in the candidate profile feed and scheduling interviews directly in Ashby. The integration supports the following:
None of these options are required, but all are recommended for the best user experience with Ashby. Further, we recommend using Domain-Wide Delegation, but also support using OAuth for email and scheduling.
| Scope Name | Description | Domain-Wide | OAuth | Scope |
|---|---|---|---|---|
| Sync users | Sync Google Workspace users to automatically provision/de-provision them as Ashby users | 🟢 | 🔴 | https://www.googleapis.com/auth/admin.directory.user.readonly |
| Sync meeting rooms | Sync meeting rooms | 🟢 | 🔴 | https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly |
| Sync calendars | Read/write shared calendars | 🟢 | 🟢 | https://www.googleapis.com/auth/calendar |
| Sync emails | Sync emails between candidates and users* | 🟢 | 🟢 | https://www.googleapis.com/auth/gmail.readonly |
| Send emails | Send emails and email sequences from within Ashby | 🟢 | 🟢 | https://www.googleapis.com/auth/gmail.send |
🟢 indicates the scope is supported for the delegation type
🔴 indicates the scope is not supported for the delegation type
*More on email syncing here
<aside> 📝 Ashby uses a Google Workspace feature called **domain-wide delegation** that allows you to install our app on your domain. Using this feature, you can grant OAuth access on behalf of all your employees, such that they do not need to grant permissions individually.
</aside>
To get started, visit Domain-wide Delegation ****then open the Configure New App dropdown and select OAuth App Name Or Client ID. Click "Add New" in the top left.
In the popover, enter the following information: