# agent402.tools User Onboarding Workflow

> agent402.tools User Onboarding Workflow is a paid API for AI agents from agent402.tools, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Runs the full user onboarding pipeline in one call: validates email, scores and hashes password, verifies TOTP 2FA, mints an internal user ID, and derives a URL-safe handle from the display name.

## Facts

- Endpoint: POST https://agent402.tools/api/skill/user-onboarding
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-user-onboarding-workflow-2d64aaab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nw6t-7K0hrbt5TACJjDPA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-tools-user-onboarding-workflow-2d64aaab -d '<json body>'
```

Example prompt: Run the full onboarding workflow for a new user signing up with email 'jane.doe@example.com', password 'Tr0ub4dor&3', display name 'Jane Doe', and their TOTP confirmation code '482910' along with the base32 TOTP secret 'JBSWY3DPEHPK3PXP' — validate everything, score the password, mint their user ID, and generate a URL handle.

## When to prefer this

Use this endpoint when you need to execute the entire new-user onboarding pipeline atomically in a single API call rather than chaining separate validation, password scoring, ID generation, 2FA verification, and slug-derivation steps. Ideal for agents orchestrating user registration flows where determinism and bundled execution reduce round-trips and state management complexity.

## Known failure modes

- Invalid or malformed email address returns a validation error
- Weak password fails scoring threshold and returns a rejection with score details
- Incorrect or expired TOTP code returns a 2FA verification failure
- Missing required fields (email, password, totpCode, totpSecret, displayName) return a 400-level error
- Display name that cannot be slugified into a valid handle returns a processing error
- Service unavailable or payment failure returns a 402 or 5xx error

## How this service works

Bundled execution of the User onboarding workflow - Take a signup form submission and run the full onboarding workup deterministically: validate the email, score the chosen password, mint a stable internal ID, derive a URL-safe handle from the display name, generate a recovery / API secret, hash the password for storage, and verify the 2FA setup code. One pass, every step a pure-CPU call.

## Output

Returns the results of the full onboarding pipeline: email validation status, password strength score and hashed value, TOTP verification outcome, a newly minted stable internal user ID, and a URL-safe handle derived from the display name — all in a single deterministic response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "email": {
   "type": "string",
   "description": "User-supplied email address"
  },
  "password": {
   "type": "string",
   "description": "User-chosen password (plaintext, will be scored then hashed; never logged)"
  },
  "totpCode": {
   "type": "string",
   "description": "6-digit code the user typed in to confirm their authenticator app is wired up"
  },
  "totpSecret": {
   "type": "string",
   "description": "Base32 TOTP secret generated during 2FA enrollment (server-side state)"
  },
  "displayName": {
   "type": "string",
   "description": "User-supplied display name (will be slugified into a URL handle)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "args": {
   "email": "ada@example.com",
   "password": "S0meStrongPassw0rd!",
   "totpCode": "492039",
   "totpSecret": "JBSWY3DPEHPK3PXP",
   "displayName": "Ada Lovelace"
  },
  "pack": "user-onboarding",
  "steps": [
   {
    "ok": true,
    "slug": "email-validate",
    "result": {}
   },
   {
    "ok": true,
    "slug": "password-strength",
    "result": {}
   },
   {
    "ok": true,
    "slug": "uuid",
    "result": {}
   },
   {
    "ok": true,
    "slug": "slugify",
    "result": {}
   },
   {
    "ok": true,
    "slug": "password",
    "result": {}
   },
   {
    "ok": true,
    "slug": "hash",
    "result": {}
   },
   {
    "ok": true,
    "slug": "totp",
    "result": {}
   }
  ],
  "summary": "7/7 steps succeeded"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-user-onboarding-workflow-2d64aaab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)