---
title: "GetSSOLoginURL"
method: POST
path: "/gitpod.v1.AccountService/GetSSOLoginURL"
tags: ["gitpod.v1.AccountService"]
---

# GetSSOLoginURL

`POST /gitpod.v1.AccountService/GetSSOLoginURL`

Gets the SSO login URL for a specific email domain.

 Use this method to:
 - Initiate SSO authentication
 - Get organization-specific login URLs
 - Handle SSO redirects

 ### Examples

 - Get login URL:

   Retrieves SSO URL for email domain.

   ```yaml
   email: "user@company.com"
   ```

 - Get URL with return path:

   Gets SSO URL with specific return location.

   ```yaml
   email: "user@company.com"
   returnTo: "https://gitpod.io/workspaces"
   ```

## Request body

- GitpodV1GetSSOLoginURLRequest
  - `email` string, email, required — email is the email the user wants to login with
  - `returnTo` string, uri, nullable — return_to is the URL the user will be redirected to after login

## Response `200`

Success

- GitpodV1GetSSOLoginURLResponse
  - `loginUrl` string, required — login_url is the URL to redirect the user to for SSO login

## Other responses

- `default` — Error

---

[API](https://skmtc.net/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.net/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/44d50c2ac284/schema)
