---
title: "Connect Link Submit"
method: POST
path: "/managed-auth/connect-links/submit"
tags: ["managed-auth"]
---

# Connect Link Submit

`POST /managed-auth/connect-links/submit`

## Headers

- `X-Notte-Connect-Token` string, required — The connect token from the link URL.

## Request body

- ConnectLinkSubmitRequest
  - `credentials` ManagedAuthCredentials, required
    - `username` string, nullable
    - `email` string, nullable
    - `password` string, password, required
    - `mfa_secret` string, password, nullable
  - `mailbox_id` string, nullable — Inbox the second-factor code will arrive in. Required when the connector reads its code from email and the link did not already name one.

## Response `202`

Successful Response

- ConnectLinkStatusResponse
  - `status` 'pending' | 'submitted' | 'completed' | 'failed' | 'expired', required
  - `connection_status` string, nullable
  - `failure_code` 'invalid_credentials' | 'mfa_required' | 'mfa_invalid' | 'account_locked' | 'captcha' | 'site_changed' | 'transient' | 'unknown', nullable
  - `message` string, nullable
  - `attempts_remaining` integer, required
  - `success_redirect_uri` string, nullable
  - `error_redirect_uri` string, nullable

## 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/submit/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)