---
title: "Managed Auth Connect Link Create"
method: POST
path: "/managed-auth/connect-links"
tags: ["managed-auth"]
---

# Managed Auth Connect Link Create

`POST /managed-auth/connect-links`

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Request body

- ConnectLinkCreateRequest
  - `template_id` string, required — Connector this link collects credentials for.
  - `label` string, required — Name the resulting connection is created with.
  - `external_user_id` string, nullable — Your own identifier for the end user. Echoed back on the completion webhook.
  - `two_fa_method` 'email' | 'sms' | 'totp', nullable — Second factor this connection will use. Required when the connector supports more than one, because the choice decides whether a mailbox is needed.
  - `mailbox_id` string, nullable — Mailbox to read email 2FA codes from. Required when the resolved method is email.
  - `success_redirect_uri` string, nullable — Where the end user is sent once the account is connected.
  - `error_redirect_uri` string, nullable — Where the end user is sent when the connection cannot be completed.
  - `webhook_url` string, nullable — Receives the signed completion callback. See the connect-link webhook docs.
  - `ttl_seconds` integer — How long the link stays usable.
  - `schedule` boolean — Whether the resulting connection re-authenticates on a schedule.

## Response `201`

Successful Response

- ConnectLinkCreateResponse
  - `connect_link_id` string, required
  - `connect_url` string, required — Send your end user here.
  - `token` string, required — Returned once and never again - only its hash is stored.
  - `expires_at` string, date-time, required
  - `webhook_signing_secret` string, nullable — Workspace secret to verify the completion webhook with. Present only when a webhook_url was supplied. Stable across links, so it is safe to store once.

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-01** `442ff5940528` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/notte/apis/notte-api/changes/managed-auth/connect-links/post.md)

---

[API](https://skmtc.dev/notte/apis/notte-api.md) · [All operations](https://skmtc.dev/notte/apis/notte-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/notte/notte-api/revisions/5926cd7ca3c3/schema)