---
title: "Initiate Wholesale Signup"
method: POST
path: "/api/v1/auth/signup/wholesale/initiate"
tags: ["User APIs", "auth"]
---

# Initiate Wholesale Signup

`POST /api/v1/auth/signup/wholesale/initiate`

Redeem a signup link and start a wholesale signup session. Validates the
link (active, unexpired, capacity) and the email domain, then stages the
signer and sends the email verification code.

## Headers

- `x-captcha-token` string, required

## Request body

- WholesaleSignupInitiateRequest — Start a wholesale (distributor) signup by redeeming a signup link. No plan/subscription-period selection and no payment: the tier and terms come from the link's contract. ``accept_terms`` records the signer's acceptance of the distributor's click-through TOU.
  - `token` string, required — Distributor signup link token
  - `email` string, email, required
  - `password` string, required
  - `first_name` string, required — User's first/given name
  - `last_name` string, required — User's last/family name
  - `company_name` string, nullable — Company name used as the wholesale client name
  - `accept_terms` boolean, required — Must be true - the signer accepted the distributor's TOU
  - `tou_id` string, nullable — UUID of the distributor TOU version displayed to and accepted by the signer (from the landing GET)
  - `marketing_opt_in` boolean

## Response `200`

Successful Response

- SignupInitiateResponse
  - `session_id` string, required
  - `email` string, required
  - `status` string, required
  - `capi_event_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)