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

# Initiate Signup

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

Start a new signup session.

- Validates password / plan / subscription_period at the schema layer
- Rejects emails already registered as real users
- Stages an Okta user (activate=false) so Okta's password-policy checks
  surface synchronously
- Creates a PendingSignup in DRAFT with the staged okta_user_id, issues a
  verification code, sends the verification email, and transitions to
  EMAIL_VERIFICATION_IN_PROGRESS.

## Headers

- `x-captcha-token` string, required

## Request body

- SignupInitiateRequest
  - `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 — Optional company name to be used as the client name
  - `selected_plan_id` string, required — Plan ID: 'business' or 'professional'
  - `subscription_period` string, required — Subscription billing period: 'monthly' or 'annual'
  - `signup_tou_id` string, required — UUID of the Terms of Use version accepted by the user
  - `marketing_opt_in` boolean
  - `fbp` string, nullable — Meta _fbp browser cookie
  - `fbc` string, nullable — Meta _fbc click ID cookie
  - `marketing_consent` boolean — Visitor granted the CMP's marketing category. Defaults to False so a caller that omits it sends no Meta CAPI event (PRO-3255).

## 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)