User APIs
auth

Initiate Wholesale Signup

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.

post/api/v1/auth/signup/wholesale/initiate

Headers

x-captcha-tokenstring required

Request body

tokenstring required

Distributor signup link token

emailstring email required
passwordstring required
first_namestring required

User's first/given name

last_namestring required

User's last/family name

company_namestring nullable

Company name used as the wholesale client name

accept_termsboolean required

Must be true - the signer accepted the distributor's TOU

tou_idstring nullable

UUID of the distributor TOU version displayed to and accepted by the signer (from the landing GET)

marketing_opt_inboolean

Response

Successful Response

session_idstring required
emailstring required
statusstring required
capi_event_idstring nullable