---
title: "Start OAuth authorization for an integration"
method: POST
path: "/v1/oauth/{vendor_id}/authorize"
tags: ["oauth-connect"]
---

# Start OAuth authorization for an integration

`POST /v1/oauth/{vendor_id}/authorize`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/oauth/{vendor_id}/authorize`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Returns an authorize URL. The frontend opens it in a popup; the user approves on the vendor's site; the vendor redirects back to /callback which stores the connection and messages the opener window.

## Path parameters

- `vendor_id` string, required

## Request body

- AuthorizeRequest
  - `integration_id` string, required: Integration being connected (e.g. 'zoho_sprints')
  - `region` string, nullable: Provider region (e.g. 'in', 'com', 'eu')
  - `display_name` string, nullable: User-chosen label for this connection
  - `return_to` string, nullable: Frontend URL to redirect to after success
  - `extra_scopes` string[], nullable: Additional scopes to request (for scope-upgrade flows)

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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