---
title: "Create auth link"
method: POST
path: "/v1/connections/auth-link"
tags: ["Connections"]
---

# Create auth link

`POST /v1/connections/auth-link`

## Request

- Base URL: `https://api.markifact.com`
- URL: `https://api.markifact.com/v1/connections/auth-link`
- Auth: HTTP bearer

Create a shareable OAuth link that connects an external account to your Markifact team.

## Request body

- CreateAuthLinkRequest
  - `connection_type` string, required
  - `redirect_url` string, uri
  - `external_id` string
  - `is_private` boolean: Whether the created connection should be private to the API-key user. Defaults to false, meaning shared with the workspace so other team members can see and use it.

## Response `200`

Auth link created.

- AuthLink
  - `id` string, required
  - `url` string, uri, required
  - `expires_at` integer, required

## Other responses

- `400`: Invalid request.

---

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