# SAML via Google Workspace

> Set up SAML single sign-on for Taskade with Google Workspace, so your team logs in with the Google accounts they already use.

- Source: https://www.taskade.com/learn/account/saml-google
- Section: Help & Account
- Updated: 2026-10-19
- Index of all pages: https://www.taskade.com/learn/llms.txt

Set up SAML single sign-on so your team logs in to Taskade with their Google Workspace accounts. The setup takes about 10 minutes, in Google first and then in Taskade.

> **TL;DR:** In Google Workspace, add a custom SAML app with ACS URL `https://www.taskade.com/saml/sso/login/callback` and Entity ID `https://www.taskade.com/saml/sso/metadata`. Copy the SSO URL, Entity ID, and certificate into **Settings → Organization → SAML SSO** in Taskade. SAML is on Business, Max, and Enterprise. Enterprise adds [SCIM provisioning](https://www.taskade.com/learn/account/scim-overview).

In this guide, you will:

- Add Taskade as a custom SAML app in Google Workspace
- Connect Google to your Taskade organization
- Let your team log in with single sign-on

## What Is SAML?

SAML is the security standard that lets your team sign in to Taskade with their Google Workspace credentials. They need no separate Taskade password. Identity, deprovisioning, and audit trails stay in your Google admin console.

## Before You Start

You need admin access in Google Workspace and a Taskade plan that includes SAML.

| Requirement | Details |
| --- | --- |
| Plan | Business, Max, or Enterprise |
| Your Taskade account | Uses your company email address, not a personal one, and the email address is verified |
| Google access | You can add apps in the Google Workspace admin console |
| Time | About 10 minutes |

> **Important:** If your team already uses Taskade, your identity provider takes ownership of those accounts. Tell your team before you turn on SAML.

```mermaid
graph TD
    A[Add a custom SAML app in Google Workspace] --> B[Copy the SSO URL, Entity ID, and certificate]
    B --> C[Paste them into Taskade Organization settings]
    C --> D[Team logs in with Single Sign-On]
    style A fill:#0d1b2a,color:#7dd3fc,stroke:#38bdf8,stroke-width:1.5px
    style B fill:#2a1225,color:#ff8fa3,stroke:#ff2d60,stroke-width:2px
    style C fill:#0d1a0e,color:#86efac,stroke:#22c55e,stroke-width:1.5px
    style D fill:#1a140a,color:#ffb74d,stroke:#e65100,stroke-width:1.5px
```

## Step 1: Add a Custom SAML App in Google Workspace

Google needs an app entry for Taskade.

1. Open the Google Workspace admin console.
2. In the sidebar, go to **Apps**, then **Web and mobile apps**.
3. Click **Add app**, then **Add custom SAML app**.

![Adding a custom SAML app in the Google Workspace admin console](https://www.taskade.com/static_images/learn/account/saml-google-5cf2a1b8.png)

4. Type "Taskade" as the **App name**. You can also upload a logo.
5. Click **Next**.

![Typing Taskade as the app name for the new SAML app](https://www.taskade.com/static_images/learn/account/saml-google-a1351603.png)

## Step 2: Save the Google Sign-In Values

Google shows three values that Taskade needs in Step 5.

1. Copy the **SSO URL**, the **Entity ID**, and the **Certificate** into a file.
2. Click **Continue**.

![The Google identity provider details with the SSO URL, Entity ID, and Certificate](https://www.taskade.com/static_images/learn/account/saml-google-bd5f0ba9.png)

## Step 3: Enter the Taskade Details in Google

Google asks for the Taskade details next.

| Field | Value |
| --- | --- |
| **ACS URL** | `https://www.taskade.com/saml/sso/login/callback` |
| **Entity ID** | `https://www.taskade.com/saml/sso/metadata` |
| **Name ID Format** | Email |
| **Name ID** | Basic Information, Primary email |

1. Type each value from the table.
2. Click **Continue**.

![The service provider details with the ACS URL and Entity ID filled in](https://www.taskade.com/static_images/learn/account/saml-google-0abffa26.png)

3. Under **Google Directory attributes**, select **Primary email**. Type `email` as the **App attribute**.

![Mapping the Primary email attribute to email](https://www.taskade.com/static_images/learn/account/saml-google-8dc35d27.png)

## Step 4: Turn the App On for Your Users

The app must be on for the people who log in to Taskade.

1. Click the arrow in the **User access** section.

![Opening the User access section of the Taskade SAML app](https://www.taskade.com/static_images/learn/account/saml-google-45219e14.png)

2. Choose **ON for everyone**.
3. Click **Save**.

![Choosing ON for everyone and saving](https://www.taskade.com/static_images/learn/account/saml-google-dc564043.png)

The Google Workspace part is complete. Finish in Taskade.

## Step 5: Paste the Values Into Taskade

The **SAML SSO** form in Taskade takes the values from Step 2.

| Taskade field | What to paste |
| --- | --- |
| **Domain** | Your company domain, for example `company.com`, without `https://` or `www.` |
| **SSO URL** | The **SSO URL** from Step 2 |
| **IDP Issuer** | The **Entity ID** from Step 2 |
| **IDP Public Signing Cert** | The **Certificate** from Step 2 |

1. Go to [taskade.com/settings](https://www.taskade.com/settings) and open **Organization**, then **SAML SSO**.
2. Type each value from the table.
3. Under **Default Workspace**, select the workspace that people sign in to. It must be on the [Business plan or above](https://www.taskade.com/learn/account/premium-plans) and owned by you.
4. Click **Configure**.

```text
┌──────────────────────────────────────────────────────────┐
│  SAML                                                    │
│  Configure single sign-on using SAML identity providers  │
│  (Okta, Google Workspace, OneLogin, Auth0).              │
│  Domain                   [ company.com              ]   │
│  SSO URL                  [                          ]   │
│  IDP Issuer               [                          ]   │
│  IDP Public Signing Cert  [                          ]   │
│  Default Workspace        [x] Your workspace             │
│                                          [ Configure ]   │
└──────────────────────────────────────────────────────────┘
```

You cannot change the default workspace after you configure it. To change it later, contact [support@taskade.com](mailto:support@taskade.com).

## Step 6: Verify Your Domain

Single sign-on stays off for your domain until you prove that you control it. Taskade checks a TXT record at your DNS provider.

1. After you click **Configure**, find **Domain not verified** on the **SAML SSO** page.
2. Click **Copy** next to the **Host**, then next to the **Value**.
3. At your DNS provider, add a TXT record with that host and that value.
4. In Taskade, click **Verify domain**.
5. Wait for **Domain verified** and the date.

If Taskade shows "We could not find that TXT record yet. DNS changes can take time.", wait a few minutes. Then click **Verify domain** again.

A setup that you made before this check keeps working for now. Its page says "Single sign-on keeps working for company.com for now." (with your domain) Add the TXT record and verify before domain proof becomes required.

## You Are Done When

A teammate goes to [taskade.com/login](https://taskade.com/login), clicks **Log in with Single Sign-On**, signs in with Google, and lands in your workspace. A new teammate can also start at [taskade.com/signup](https://taskade.com/signup). There, **Sign up with Single Sign-On** is a text link under the Google and Apple buttons.

## Troubleshooting

Find what you see in the left column, then do the fix.

| What you see | Why | Fix |
| --- | --- | --- |
| No workspace to pick under **Default Workspace** | You do not own a workspace on Business or above | Upgrade a workspace that you own, then open the form again. |
| Single sign-on does not start, and the page shows **Domain not verified** | Taskade cannot find the TXT record for your domain | Add the TXT record from the **SAML SSO** page at your DNS provider, then click **Verify domain**. |
| **Log in with Single Sign-On** does not accept an email | The email domain does not match the **Domain** field | Type the domain exactly as `company.com`, with no `https://` or `www.`. |
| Google refuses the sign-in | The Taskade app is off for that person | In Google, set **User access** to **ON for everyone**. |

## Frequently Asked Questions

**Which Taskade plans include SAML single sign-on?**

Business, Max, and Enterprise. Enterprise also adds [SCIM provisioning](https://www.taskade.com/learn/account/scim-overview), which creates and removes accounts from your directory.

**Does SAML change sign-in for my published apps?**

No. SAML controls how your team logs in to Taskade. Sign-in for the visitors of your published Taskade Genesis apps works on every plan, and a [custom domain](https://www.taskade.com/learn/genesis/custom-domains) for an app needs Pro or above.

**Can I change the default workspace later?**

Not from the form. Contact [support@taskade.com](mailto:support@taskade.com) to change it.

## Next Steps

Add automatic accounts and more protection on top of single sign-on.

1. **Compare plans**: See what each tier includes in the [Plan Matrix](https://www.taskade.com/learn/account/plan-matrix).
2. **Provision accounts**: Automate joiners and leavers with [SCIM via Okta](https://www.taskade.com/learn/account/scim-okta).
3. **Use another provider**: See [SAML via Okta](https://www.taskade.com/learn/account/saml-okta) or [SAML via Azure AD](https://www.taskade.com/learn/account/saml-azure).
4. **Add a second step**: Turn on [Two-Factor Authentication](https://www.taskade.com/learn/account/mfa-setup).
5. **Control access after sign-in**: See [Workspace Privacy](https://www.taskade.com/learn/account/workspace-privacy).
