---
title: "Connect the chat identity of a /connect link to my account (I must be an active member of the organization the chat belongs to)"
method: POST
path: "/api/me/channel-links"
tags: ["me"]
---

# Connect the chat identity of a /connect link to my account (I must be an active member of the organization the chat belongs to)

`POST /api/me/channel-links`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/me/channel-links`
- Auth: none declared

## Request body

- ChannelLinkBody
  - `t` string, required: The token of the /connect link.
  - `mode` 'auto' | 'confirm'

## Response `200`

OK.

- union
  - object
    - `status` 'linked', required
    - `link` ChannelLink, required
      - `id` string, required
      - `channel` string, nullable, required
      - `label` string, required
      - `orgId` string, nullable, required
      - `linkedAt` string, nullable, required
      - `proof` 'signed_link' | 'microsoft_identity' | 'null', nullable, required
    - `org` object, required
      - `id` string, required
      - `name` string, required
    - `proof` 'signed_link' | 'microsoft_identity', required
    - `already` boolean, required
  - object
    - `status` 'confirm_required', required
    - `preview` ConnectPreview, required
      - `status` 'valid' | 'expired' | 'used' | 'invalid', required
      - `channel` string
      - `orgName` string
      - `hint` string
      - `displayName` string
      - `expiresAt` string
      - `methods` string[], nullable

## Other responses

- `400`: connect_link_invalid.
- `403`: connect_not_member: not a member of the organization (`org`).
- `409`: connect_link_used, or connect_already_linked (another account).
- `410`: connect_link_expired.
- `503`: connect_unavailable.

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)