---
title: "Authorize"
method: GET
path: "/oauth/microsoft-ads/authorize"
tags: ["oauth"]
---

# Authorize

`GET /oauth/microsoft-ads/authorize`

## Request

- Base URL: `https://api.adplug.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.adplug.app/oauth/microsoft-ads/authorize`
- Auth: none declared

Start the Microsoft Ads OAuth flow. Returns a redirect to Microsoft's consent screen.

`return_to` is an optional same-origin path that the callback will redirect
to on success/failure instead of the default /dashboard/connections. Used by
onboarding Step 4 to keep the user inside the 5-step flow.

## Query parameters

- `user_id` string, required
- `session_token` string, nullable
- `return_to` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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