---
title: "Hosted OAuth - Authorization Request"
method: GET
path: "/v3/connect/auth"
tags: ["Authentication APIs"]
---

# Hosted OAuth - Authorization Request

`GET /v3/connect/auth`

The initial OAuth 2.0 authorization request. Use this endpoint with the required query parameters to start the OAuth 2.0 process. The query parameters pass details to the Nylas API about how the user should authenticate, and where they should go after authenticating.
This endpoint supports the authorization code flow and optional PKCE settings for client-side only applications. For more information, see the  [Hosted OAuth with access token](/docs/v3/auth/hosted-oauth-accesstoken/) and [Hosted OAuth with access token and PKCE](/docs/v3/auth/hosted-oauth-accesstoken/#create-grants-with-oauth-2.0-and-pkce) documentation.

## Query parameters

- `client_id` string, required
- `provider` 'google' | 'microsoft' | 'imap' | 'icloud' | 'yahoo' | 'ews' | 'zoom'
- `redirect_uri` string, required
- `response_type` 'code' | 'adminconsent', required
- `scope` string
- `prompt` 'select_provider' | 'detect' | 'select_provider,detect' | 'detect,select_provider'
- `state` string
- `login_hint` string
- `access_type` 'offline' | 'online'
- `code_challenge` string
- `code_challenge_method` 'plain' | 'S256'
- `credential_id` string
- `options` string

## Other responses

- `302` — Redirects user to provider's authorization page
- `400` — Bad Request

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)