---
title: "Invite to a Membership"
method: POST
path: "/memberships/invite"
tags: ["Memberships"]
---

# Invite to a Membership

`POST /memberships/invite`

Sends an email inviting one recipient to join the account through a free plan. Identify the recipient by exactly one of `user_id` or `email`. The invitation is bound to that recipient; after signing in, accepting it immediately grants the membership without checkout. This Experimental endpoint is available only to accounts enabled for membership invitations.

## Headers

- `Idempotency-Key` string

## Request body

- union
  - object
    - `plan_id` string, required — Free plan whose membership the recipient is invited to, prefixed `plan_`.
    - `user_id` string, required — Recipient user ID, prefixed `user_`. Mutually exclusive with `email`.
    - `email` string, email — Recipient email address. Mutually exclusive with `user_id`.
  - object
    - `email` string, email, required — Recipient email address. Mutually exclusive with `user_id`.
    - `plan_id` string, required — Free plan whose membership the recipient is invited to, prefixed `plan_`.
    - `user_id` string — Recipient user ID, prefixed `user_`. Mutually exclusive with `email`.

## Response `202`

invitation accepted for delivery

- object
  - `invitation_sent` boolean, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)