---
title: "Get Admin Consent URL"
method: GET
path: "/v2/mailbox-settings/microsoft/consent-url"
tags: ["mailbox-settings"]
---

# Get Admin Consent URL

`GET /v2/mailbox-settings/microsoft/consent-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/mailbox-settings/microsoft/consent-url`
- Auth: HTTP bearer

Resolves the org's Entra tenant, registers (or reuses) a **per-tenant**
Nylas adminconsent credential for it, and returns the **Nylas-hosted**
admin-consent URL bound to that credential. Consent runs through Nylas so it
binds to the per-tenant credential on Nylas's side — required before an
application grant can be minted. A single shared ``tenant=common`` credential
can't back multiple tenants (its consent is single-tenant and re-consenting
one evicts the others), so every org gets its own credential.

## Query parameters

- `redirect_uri` string, required

## Response `200`

Successful Response

- ConsentUrlResponse
  - `url` string, required: Admin consent URL for the configured provider.

## 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/ff0ad16a55ff?raw)