> ## Documentation Index
> Fetch the complete documentation index at: https://hexelstudio.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Initiate Service Authorization

> Initiate the OAuth 2.0 authorization flow for a specified third-party service.
The frontend provides requested_scopes and a redirect_url for post-auth callback.

Initiate the OAuth 2.0 authorization flow for a specified third-party service.

* **Method:** POST
* **Path:** `/api/v1/services/authorize/{service_name}`

## Path Parameter

* `service_name` (string, required): The name of the service

## Request Body

Refer to the `ServiceAuthorizationRequest` schema in the OpenAPI playground.

## Response

Returns a `ServiceAuthorizationResponse` object on success.

<OpenAPIPlayground endpoint="/api/v1/services/authorize/{service_name}" method="POST" />