---
title: "Get Auth Url"
method: GET
path: "/email/auth/url"
tags: ["email"]
---

# Get Auth Url

`GET /email/auth/url`

## Request

- Base URL: `https://stardrift.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://stardrift.ai/email/auth/url`
- Auth: none declared

## Query parameters

- `return_to` string, nullable
- `platform` string, nullable: Client platform: 'mobile' for app deep-link redirect, omit for web
- `source` string, nullable: Which surface started the connect, e.g. 'bookings-page'; reported in the Slack connect alert

## Response `200`

Successful Response

- AuthUrlResponse
  - `auth_url` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-16** `6d2ccd9ff8ca`: 1 info
  - added the new optional `query` request parameter `source`

[Operation history](https://skmtc.dev/stardrift/apis/stardrift-api/changes/email/auth/url/get.md)

---

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