---
title: "POST /api/v1/auth/family-invitation"
method: POST
path: "/api/v1/auth/family-invitation"
tags: ["Authentication", "Family"]
---

# POST /api/v1/auth/family-invitation

`POST /api/v1/auth/family-invitation`

Creates one isolated Product account and session from a valid family invitation. The shared Membership allowance is attached atomically.

## Request body

- object
  - `name` string, required
  - `password` string, required
  - `token` string, required

## Response `200`

Guest account, family access, and Product session created.

- object
  - `redirectTo` '/dashboard', required
  - `status` 'complete', required

## Other responses

- `400` — The request does not match the strict acceptance contract.
- `403` — The request did not originate from this Product.
- `404` — The family Membership is not configured for invitations.
- `409` — The invitation is expired, revoked, used, belongs to another Product, the family is full, or the Product account already exists.

---

[API](https://skmtc.dev/expertschat/apis/billing-core-api.md) · [All operations](https://skmtc.dev/expertschat/apis/billing-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/expertschat/billing-core-api/revisions/c6d0e986ce32/schema)