---
title: "Start Account Registration"
method: POST
path: "/v1/onboarding/registrations/account"
tags: ["onboarding"]
---

# Start Account Registration

`POST /v1/onboarding/registrations/account`

## Request

- Base URL: `https://api.4chems.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.4chems.com/v1/onboarding/registrations/account`
- Auth: none required

Start registering a 4chems account with a business email address (`email`,
`name`, optional `company`). Anonymous. Emails a 6-digit code to the address;
no account exists yet. Ask the user for the code, then call
verify_account_registration with the returned challenge_id and code. Free-mail
addresses (gmail.com, ...) are refused: use the company address, or call
start_inquiry. The answer is the same whether or not the address already has
an account.

## Request body

- AccountRegistrationIn: Request body for POST /v1/onboarding/registrations/account (UC-088).
  - `email` string, required
  - `name` string, required
  - `company` string, nullable

## Response `201`

Successful Response

- AccountChallengeOut
  - `challenge_id` string, uuid, required
  - `expires_in_seconds` integer, required
  - `next_step` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/4chems/apis/platform-api.md) · [All operations](https://skmtc.dev/4chems/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/4chems/apis/platform-api/revisions/65e4f7b4dba0?raw)