---
title: "Start Authorization"
method: POST
path: "/v1/integrations/microsoft/{connection_kind}/authorizations"
tags: ["microsoft"]
---

# Start Authorization

`POST /v1/integrations/microsoft/{connection_kind}/authorizations`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/integrations/microsoft/{connection_kind}/authorizations`
- Auth: HTTP bearer

## Path parameters

- `connection_kind` 'sharepoint' | 'onedrive' | 'outlook', required

## Request body

- AppIntegrationsMicrosoftRouterAuthorizationStart
  - `redirect_path` string
  - `callback_origin` string, nullable
  - `select_account` boolean
  - `workspace_id` string, uuid, nullable
  - `calendar_suggestions` boolean

## Response `201`

Successful Response

- AuthorizationResponse
  - `attempt_id` string, uuid, required
  - `authorization_url` string, required
  - `expires_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)