> For the complete documentation index, see [llms.txt](https://documentation.pushly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.pushly.com/platform/organizations/single-sign-on/google-workspace.md).

# Google Workspace

## In Google Workspace: Create OAuth 2.0 Client Credentails

An administrator for your company's Google Workspace needs to log in to the [API Console](https://console.developers.google.com/) and follow the steps below to create new OAuth 2.0 Client Credentials.

From the projects list, select an existing project or create a new one.

If the `APIs & Services` page isn't already open, open the console left side menu and select APIs & services.

On the left, click `Credentials`.

<figure><img src="/files/8Mn1KHMAr2QpEeUMdsGi" alt=""><figcaption></figcaption></figure>

Click `Create Credentials`, then select `OAuth client ID`

Choose `Web Application` for `Application type` and name it "Pushly"

Under `Authorized JavaScript origins` enter the following value:&#x20;

```
https://identity.pushly.com
```

Under `Authorized redirect URIs` enter the following value:

```
https://identity.pushly.com/login/callback
```

Click the `Create` button. A modal will show on the next page that includes the `Client ID` and `Client Secret`. Copy down both of these values to be used in the next step.

## Pushly: Create the Google Workspace Identity Provider

Now that you have your `Client ID`, and `Client Secret` you can log into the platform and [navigate to your Organization Settings](/platform/organizations.md#accessing-organization-context) page.

Next, click the `Security` tab, and click the `Add Provider` button.

Choose `Google Workspace` from the `Provider Type` dropdown.

Provide the `Google Domain` which is the Google Workspace domain name for your organization.

Fill in the `Client ID` and `Client Secret` that was generated in the first step of this documentation.

Within the `Associated Domains` text area enter each domain name that your organization will be using to to log in via Google Workspace on a separate line. For example, if your email address is `example@yourdomain.com` then you would enter `yourdomain.com`

<figure><img src="/files/sjOZH5x4jh6NHmbdn4C3" alt=""><figcaption></figcaption></figure>

Once the provider has been successfully created you can begin [inviting users](/platform/user-management.md#creating-a-user) to the platform. Any user invited that has an email address that matches one of the emails provided in `Email Domains` will be sent through Google Workspace for authentication.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.pushly.com/platform/organizations/single-sign-on/google-workspace.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
