---
title: "Get Delegated OAuth URL"
method: GET
path: "/v2/mailboxes/auth/url"
tags: ["mailboxes"]
---

# Get Delegated OAuth URL

`GET /v2/mailboxes/auth/url`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/mailboxes/auth/url`
- Auth: HTTP bearer

Returns the hosted-OAuth URL for a user to sign in and connect their
personal mailbox. Uses the org's Nylas credential when one is set,
otherwise falls back to the connector defaults.

## Query parameters

- `redirect_uri` string, required
- `provider` 'microsoft' | 'google', nullable
- `email` string, nullable
- `email_sender_id` string, nullable

## Response `200`

Successful Response

- AuthUrlResponse
  - `url` string, required: Hosted-OAuth URL for the user to sign in.

## Other responses

- `422`: Validation Error

---

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