# SAML via Okta

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

- Source: https://www.taskade.com/learn/account/saml-okta
- 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 Okta credentials. The setup takes about 10 minutes, in Okta first and then in Taskade.

> **TL;DR:** In Okta, create a SAML 2.0 app with Single sign-on URL `https://www.taskade.com/saml/sso/login/callback` and Audience URI `https://www.taskade.com/saml/sso/metadata`. Map an `email` attribute to `user.email`. Copy Okta's SSO URL, Issuer, and X.509 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-okta).

In this guide, you will:

- Create a Taskade app integration in Okta
- Connect Okta to your Taskade organization
- Assign Taskade to your people

## What Is SAML?

SAML is the security standard that lets your team sign in to Taskade with the Okta credentials they already use. They need no second password. Joiners, movers, and leavers stay managed in Okta.

## Before You Start

You need admin access in Okta 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 |
| Okta access | You can create app integrations in the Okta admin dashboard |
| 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[Create a SAML app in Okta] --> B[Set the sign-on URL and audience]
    B --> C[Copy the SSO URL, issuer, and certificate]
    C --> D[Paste them into Taskade Organization settings]
    D --> E[Assign Taskade to your people]
    style A fill:#0d1b2a,color:#7dd3fc,stroke:#38bdf8,stroke-width:1.5px
    style B fill:#1a140a,color:#ffb74d,stroke:#e65100,stroke-width:1.5px
    style C fill:#2a1225,color:#ff8fa3,stroke:#ff2d60,stroke-width:2px
    style D fill:#0d1a0e,color:#86efac,stroke:#22c55e,stroke-width:1.5px
    style E fill:#0d1a0e,color:#86efac,stroke:#22c55e,stroke-width:1.5px
```

## Step 1: Create the App Integration in Okta

Okta needs an app integration for Taskade.

1. In your Okta dashboard, go to **Applications**.
2. Click **Create App Integration**.

![Clicking Create App Integration in the Okta dashboard](https://www.taskade.com/static_images/learn/account/saml-okta-c7fb91d1.png)

3. Choose **SAML 2.0**, then click **Next**.

![Choosing SAML 2.0 as the sign-in method](https://www.taskade.com/static_images/learn/account/saml-okta-7fae851a.png)

4. In **General Settings**, type "Taskade" as the **App name**. You can also upload a logo.

![Typing Taskade as the app name in General Settings](https://www.taskade.com/static_images/learn/account/saml-okta-b9cad6f9.png)

## Step 2: Enter the Taskade Details in Okta

The **Configure SAML** screen takes the Taskade values.

| Field | Value |
| --- | --- |
| **Single sign-on URL** | `https://www.taskade.com/saml/sso/login/callback` |
| **Audience URI (SP Entity ID)** | `https://www.taskade.com/saml/sso/metadata` |
| **Name ID format** | EmailAddress |

1. Type each value from the table.
2. Keep **Use this for Recipient URL and Destination URL** checked.

![The Configure SAML screen with the Taskade values filled in](https://www.taskade.com/static_images/learn/account/saml-okta-b27b61e0.png)

3. Go to **Attribute Statements (optional)**.
4. Add an attribute with **Name** `email` and **Value** `user.email`.

![Adding the email attribute statement](https://www.taskade.com/static_images/learn/account/saml-okta-4432a5dc.png)

## Step 3: Finish the Okta Setup

Okta then shows the values that Taskade needs.

1. Scroll down and click **Next**.
2. When Okta asks, select **I'm an Okta customer adding an internal app**.
3. If Okta asks "Which app pages did you consult to configure SAML?", paste `https://www.taskade.com/learn/account/saml-okta`. Paste the same link for "Did you find SAML docs for this app?"
4. Scroll down and click **Finish**.
5. On the next page, find **SAML Setup** on the right and click **View SAML setup instructions**.
6. Keep this page open. You copy three values from it in Step 4.

![The SAML Setup panel with the View SAML setup instructions button](https://www.taskade.com/static_images/learn/account/saml-okta-7fa7541a.png)

## Step 4: Paste the Okta Values Into Taskade

The **SAML SSO** form in Taskade takes the values from the Okta instructions page.

| Taskade field | What to paste from the Okta instructions page |
| --- | --- |
| **Domain** | Your company domain, for example `company.com`, without `https://` or `www.` |
| **SSO URL** | Identity Provider Single Sign-On URL |
| **IDP Issuer** | Identity Provider Issuer |
| **IDP Public Signing Cert** | X.509 Certificate |

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 5: Assign Taskade to Your People

People must have the app in Okta before they can log in.

1. Open the Okta dashboard.
2. Assign the Taskade app to the people or groups in your directory.

## 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 Okta, 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.`. |
| Okta refuses the sign-in | The person is not assigned to the Taskade app | Assign the app to that person or group in Okta. |

## Frequently Asked Questions

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

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

**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. **Provision accounts**: Automate joiners and leavers with [SCIM via Okta](https://www.taskade.com/learn/account/scim-okta).
2. **Use another provider**: See [SAML via Google Workspace](https://www.taskade.com/learn/account/saml-google) or [SAML via Azure AD](https://www.taskade.com/learn/account/saml-azure).
3. **Add a second step**: Turn on [Two-Factor Authentication](https://www.taskade.com/learn/account/mfa-setup).
4. **Hand off the workspace**: See [Transfer Workspace Ownership](https://www.taskade.com/learn/account/transfer-ownership).
5. **Compare plans**: See what each tier includes in the [Plan Matrix](https://www.taskade.com/learn/account/plan-matrix).
