---
title: "Invite (enroll) a Circle member"
method: POST
path: "/api/v1/circles/{id}/members/invite"
tags: ["Circles"]
---

# Invite (enroll) a Circle member

`POST /api/v1/circles/{id}/members/invite`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/api/v1/circles/{id}/members/invite`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `auth_token`

Mint a single-use enrollment deep link (both channels + QR) for an existing member.

## Path parameters

- `id` string, required: MongoDB ObjectId

## Request body

- CircleMemberInviteBody: Request body for inviting (enrolling) a Circle member
  - `member_id` string, required: The member to mint an enrollment link for

## Response `201`

Enrollment link minted

- CircleMemberInviteResponse: A single-use member enrollment link (both channels + QR)
  - `token` string, required
  - `member_id` string, required: MongoDB ObjectId
  - `telegram_deep_link` string, required
  - `whatsapp_deep_link` string, required
  - `qr_code` string, required: QR code data URL for the primary deep link
  - `qr_text` string, required: UTF-8 text representation of the QR code
  - `expires_in` integer, required
  - `suggested_share_text` string, required: Suggested message to forward with the invite

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `404`: Circle or member not found

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/6b8d61ee354f?raw)