> **Building with AI coding agents?** If you're using an AI coding agent, install the official Scalekit plugin. It gives your agent full awareness of the Scalekit API — reducing hallucinations and enabling faster, more accurate code generation.
>
> - **Claude Code**: `/plugin marketplace add scalekit-inc/claude-code-authstack` then `/plugin install <auth-type>@scalekit-auth-stack`
> - **GitHub Copilot CLI**: `copilot plugin marketplace add scalekit-inc/github-copilot-authstack` then `copilot plugin install <auth-type>@scalekit-auth-stack`
> - **Codex**: run the bash installer, restart, then open Plugin Directory and enable `<auth-type>`
> - **Skills CLI** (Windsurf, Cline, 40+ agents): `npx skills add scalekit-inc/skills --list` then `--skill <skill-name>`
>
> `<auth-type>` / `<skill-name>`: `agent-auth`, `full-stack-auth`, `mcp-auth`, `modular-sso`, `modular-scim` — [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Google Workspace Directory

This guide helps administrators sync their Google Workspace directory with an application they want to onboard to their organization. Integrating your application with Google Workspace automates user management tasks and ensures access rights stay up-to-date.

1. ## Access the directory configuration screen

   Navigate to the Admin Portal of your application and select the "SCIM Provisioning" tab. You'll see a list of available directory providers.

   ![Directory Sync configuration screen with various provider options.](@/assets/docs/guides/scim-integrations/google-dir-sync/1.png)

2. ## Select Google Workspace

   From the list of directory providers, locate and click on "Google Workspace".

   ![Select Google Workspace from the available directory providers.](@/assets/docs/guides/scim-integrations/google-dir-sync/2.png)

3. ## Begin configuration

   Click on the "Configure" button to start setting up the Google Workspace integration.

   ![Click Configure to begin setting up the Google Workspace integration.](@/assets/docs/guides/scim-integrations/google-dir-sync/3.png)

4. ## Authorize Google Workspace

   To establish the connection, you need to authorize access to your Google Workspace directory. Click on "Authorize Google Workspace".

   ![Click Authorize Google Workspace to begin the authorization process.](@/assets/docs/guides/scim-integrations/google-dir-sync/5.png)

5. ## Sign in with Google admin account

   You'll be redirected to Google's authentication page. Sign in with your Google Workspace administrator account. If you're already signed in with multiple accounts, select "Use another account" to ensure you're using your administrator account.

   ![Select "Use another account" if you need to sign in with a different Google account.](@/assets/docs/guides/scim-integrations/google-dir-sync/6.png)

6. ## Enter administrator credentials

   Enter your Google Workspace administrator email address and password when prompted.

   ![Enter your Google Workspace administrator email address.](@/assets/docs/guides/scim-integrations/google-dir-sync/7.png)

7. ## Grant required permissions

   When prompted, review and confirm the permissions requested by the application. These permissions allow the application to read user and group information from your Google Workspace directory.

   ![Review the requested permissions for directory access.](@/assets/docs/guides/scim-integrations/google-dir-sync/16.png)

   Click "Continue" to grant the necessary permissions.

   ![Click Continue to grant directory access permissions.](@/assets/docs/guides/scim-integrations/google-dir-sync/19.png)

8. ## Select groups to sync

   After authorization, you'll see the groups available in your Google Workspace directory. Select the groups you want to synchronize with your application.

   ![Select which Google Workspace groups you want to sync with your application.](@/assets/docs/guides/scim-integrations/google-dir-sync/21.png)

9. ## Map IdP groups to application roles

   Map IdP groups to application roles to control access to your application. This needs to be enabled by the host application.

   ![Map IdP groups to application roles to control access to your application.](@/assets/docs/guides/scim-integrations/google-dir-sync/22-5.png)

10. ## Enable directory sync

    After selecting your groups, click "Enable Sync" to activate the integration.

    ![Click Enable Sync to start synchronizing users and groups from Google Workspace.](@/assets/docs/guides/scim-integrations/google-dir-sync/26.png)
**Note:** If you encounter issues during synchronization:
1. **Authorization errors**: Ensure you have sufficient privileges to authorize us to access your users and groups information from your Google Workspace directory.
2. **Missing users/groups**: We automatically fetch latest users and groups from Google Workspace directory once every hour. If you would like to trigger a sync manually, use the "Sync Now" button in the Actions menu.

---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |