Skill: User onboarding
POST /api/skill/user-onboardingBundled 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. One x402 payment runs 7 underlying tools (email-validate, password-strength, uuid, slugify, password, hash, totp); partial-success per step.
Input
| Field | Type | Description |
|---|---|---|
email * | string | User-supplied email address |
password * | string | User-chosen password (plaintext, will be scored then hashed; never logged) |
displayName * | string | User-supplied display name (will be slugified into a URL handle) |
totpSecret * | string | Base32 TOTP secret generated during 2FA enrollment (server-side state) |
totpCode * | string | 6-digit code the user typed in to confirm their authenticator app is wired up |
Example output
{
"pack": "user-onboarding",
"args": {
"email": "ada@example.com",
"password": "S0meStrongPassw0rd!",
"displayName": "Ada Lovelace",
"totpSecret": "JBSWY3DPEHPK3PXP",
"totpCode": "492039"
},
"steps": [
{
"slug": "email-validate",
"ok": true,
"result": {}
},
{
"slug": "password-strength",
"ok": true,
"result": {}
},
{
"slug": "uuid",
"ok": true,
"result": {}
},
{
"slug": "slugify",
"ok": true,
"result": {}
},
{
"slug": "password",
"ok": true,
"result": {}
},
{
"slug": "hash",
"ok": true,
"result": {}
},
{
"slug": "totp",
"ok": true,
"result": {}
}
],
"summary": "7/7 steps succeeded"
}
Try it - see the 402 challenge (free)
curl -i -X POST https://agent402.tools/api/skill/user-onboarding \
-H "Content-Type: application/json" \
-d '{"email":"ada@example.com","password":"S0meStrongPassw0rd!","displayName":"Ada Lovelace","totpSecret":"JBSWY3DPEHPK3PXP","totpCode":"492039"}'
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/skill/user-onboarding", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"email": "ada@example.com",
"password": "S0meStrongPassw0rd!",
"displayName": "Ada Lovelace",
"totpSecret": "JBSWY3DPEHPK3PXP",
"totpCode": "492039"
}),
});
Related tools
Skill: Earnings deep-dive
POST /api/skill/earnings-deep-diveBundled execution of the Earnings deep-dive workflow - Everything you need before a company reports: the upcoming earnin…
Skill: Options analytics
POST /api/skill/options-analyticsBundled execution of the Options analytics workflow - Price a European option on a live stock: pull the current quote, e…
Skill: Fixed-income desk
POST /api/skill/fixed-income-deskBundled execution of the Fixed-income desk workflow - Read the rate environment and price a bond in one workflow: the li…