---
title: "Get a hosted link to connect any mailbox"
method: GET
path: "/v1/connect/email"
tags: ["Connect"]
---

# Get a hosted link to connect any mailbox

`GET /v1/connect/email`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/connect/email`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/zernio/apis/zernio-api/docs/v1/connect/email/get.ts> (a function with typed inputs; its response is checked against the schema)

One link for any address. The page asks for the email first, sends Gmail, Google Workspace, Outlook.com and Microsoft 365 (found by domain or MX) to their OAuth connect, and every other mailbox to IMAP with the provider's app-password steps. Valid for one hour.

## Query parameters

- `profileId` string, required
- `redirect_url` string, uri
- `email` string, email
- `name` string
- `reconnectAccountId` string

## Response `200`

The hosted page URL

- object
  - `authUrl` string, uri
  - `expiresAt` string, date-time

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.

## Changes

- **2026-11-10** `d568bb00ed73`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/connect/email/get.md)

---

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