Skip to main content
You can sync your HR system into Google Workspace and have AccessOwl treat Google Workspace as your HRIS. This passes employee data (such as manager, department, role, and custom fields) into Google Workspace, which AccessOwl reads as your HRIS source. We recommend creating custom fields in Google Workspace for start date and end date. AccessOwl uses these to trigger automatic onboarding and offboarding.

​
Steps

1

Sync your HR system into Google Workspace

Set up your HR system to provision employees and their data into Google Workspace. The exact steps depend on your HR system. For Rippling, see Rippling.
2

Create custom fields in Google Workspace

  • Sign in to the Admin Console as a super administrator.
  • Go to Directory → Users.
  • At the top, select More options → Manage custom attributes.
  • Click Add Custom Attribute.
  • Create a schema and add fields:
    • start_date
    • end_date
    • contract_started_at (only if you work with contractors)
    • contract_terminated_at (only if you work with contractors)
3

Map your HR system's schema to Google Workspace

Map your HR system’s fields to the custom attributes you created in Google Workspace.

​
Finalizing the setup with AccessOwl

After syncing your HR system with Google Workspace, contact AccessOwl support and provide:
  • Schema name (shown as Category in the Google Admin Console)
  • Start date attribute name
  • End date attribute name
  • Contract start date attribute name (if you work with contractors)
  • Contract end date attribute name (if you work with contractors)
Where to find your schema name in the Google Admin ConsoleIn Google Admin, the schema name is displayed as Category. To locate it:
  1. Sign in to the Admin Console as a super administrator.
  2. Go to Directory → Users.
  3. At the top of the user list, select More options → Manage custom attributes.
  4. The Category values listed under Custom attributes are your schema names.
In the example below, the schema name is AccessOwl.Google Admin Console: Add custom fields dialog showing Category field set to AccessOwl with start_date and end_date fields
Once configured, AccessOwl will:
  • Sync all other fields (department, role, manager) from Google Workspace.
There are two separate date pairs, and they serve different purposes: start_date / end_date (required) This is the pair every setup needs. It drives employee onboarding and offboarding:
  • AccessOwl automatically onboards employees based on the start_date.
  • AccessOwl automatically offboards employees based on the end_date.
contract_started_at / contract_terminated_at (optional, contractors only) This is a separate pair used only to manage access for contractors. If you do not manage contractors you can skip it. Nothing is missing from your setup without it.