---
title: "Start a provider connection"
method: POST
path: "/users/@me/connections/oauth/{provider_id}/authorize"
tags: ["Connections"]
---

# Start a provider connection

`POST /users/@me/connections/oauth/{provider_id}/authorize`

## Request

- Base URL: `https://web.fluxer.app/api/v1`
- URL: `https://web.fluxer.app/api/v1/users/@me/connections/oauth/{provider_id}/authorize`
- Auth: API key in header `Authorization`

Starts connecting an account at one of the OAuth or OpenID Connect providers listed in the instance discovery document under services.connection_providers. Open authorize_url in a browser. The provider sends the browser back to the API, which adds the connection and redirects to the web app.

## Path parameters

- `provider_id` string, required: Connection provider id: lowercase letters, digits, hyphens and underscores, up to 32 characters

## Response `200`

Success

- OAuthConnectionAuthorizeResponse
  - `authorize_url` string, required: The URL to open so the user can approve the connection at the provider

## Other responses

- `400`: Bad Request - The request was malformed or contained invalid data
- `401`: Unauthorized - Authentication is required or the token is invalid
- `403`: Forbidden - You do not have permission to perform this action
- `429`: Too Many Requests - You are being rate limited
- `500`: Internal Server Error - An unexpected error occurred

## Changes

> 70 revisions in range; 2 not diffed.

- **2026-11-08** `2092bc8b2edf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fluxer/apis/fluxer-api/changes/users/@me/connections/oauth/:provider_id/authorize/post.md)

---

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