---
title: "Mint a hosted connect link for an OAuth/browser provider"
method: POST
path: "/connections/links"
---

# Mint a hosted connect link for an OAuth/browser provider

`POST /connections/links`

## Request

- Base URL: `https://worker.openhelm.ai/v1`
- URL: `https://worker.openhelm.ai/v1/connections/links`
- Auth: HTTP bearer

Returns a short-lived signed URL to the hosted connect flow for providers that need a browser (Google, Notion, LinkedIn…). Open it once to authorise, then poll GET /connections until the connection shows as authenticated.

## Request body

- object
  - `provider` string, required: e.g. 'google', 'github', 'notion'.
  - `name` string: Optional label for the resulting connection.
  - `project_id` string: Optionally scope to one project.

## Response `201`

Link created

## Other responses

- `400`: Connect disabled / missing provider

---

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