---
title: "Sso Start"
method: POST
path: "/api/v1/auth/sso/{provider}/start"
---

# Sso Start

`POST /api/v1/auth/sso/{provider}/start`

## Request

- Base URL: `https://api.mesharc.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mesharc.dev/api/v1/auth/sso/{provider}/start`
- Auth: none declared

Where to send the browser, and the binding the front end keeps in an
httpOnly cookie until the provider sends the browser back.

## Path parameters

- `provider` string, required

## Request body

- SSOStartRequest
  - `next` string, nullable
  - `invite` string, nullable
  - `intent` string
  - `attribution` SignupAttribution: Where the account came from, as the site's first-visit cookie recorded it; the app's proxy adds it, and users.clean_attribution trusts none of it.
    - `source` string, nullable
    - `medium` string, nullable
    - `campaign` string, nullable
    - `term` string, nullable
    - `content` string, nullable
    - `referrer` string, nullable
    - `landing` string, nullable
    - `firstSeen` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mesharc/apis/mesharc-api.md) · [All operations](https://skmtc.dev/mesharc/apis/mesharc-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mesharc/apis/mesharc-api/revisions/d63cc02dfec2?raw)
