NexusKit

Module

Onboarding

Multi-step onboarding flows with progress tracking, completion webhooks, and bot protection built in.

Start freeAPI docs

Features

Everything you need to run structured onboarding flows via API.

Multi-step flows

Define onboarding flows with arbitrary JSON steps. Each step collects data and advances the session.

Progress tracking

Track currentStep, accumulated payload, and completion status per session.

Completion webhooks

Fire onboarding.completed events to your webhook endpoints when a session finishes.

Turnstile captcha

Bot protection on the first step via Cloudflare Turnstile. Skippable in development.

Honeypot protection

Hidden field on step 0 silently discards bot sessions.

CSV export

Export all sessions with completion status, payloads, and timestamps.

Use cases

Any workflow that collects data step-by-step can use NexusKit Onboarding.

Customer onboarding

Guide new users through account setup, preferences, and first steps in your product.

Lead qualification

Multi-step forms that collect progressively more detail before routing to sales.

Employee onboarding

Structured workflows for new hire setup, document collection, and training progress.

KYC and verification

Step-by-step identity verification flows with document upload and review stages.

How the API works

Create a flow, start a session, and advance step by step.

1. Create a flow

POST /v1/onboarding/flows
{
  "name": "New User Setup",
  "steps": [
    { "type": "info", "label": { "en": "Welcome" } },
    { "type": "form", "label": { "en": "Your details" } },
    { "type": "confirm", "label": { "en": "Review" } }
  ]
}

2. Start a session

POST /v1/public/onboarding/flows/:flowId/sessions
{
  "locale": "en",
  "turnstileToken": "..."
}

3. Advance step by step

PATCH /v1/public/onboarding/sessions/:sessionId
{
  "payload": { "name": "Jane", "email": "[email protected]" }
}
// Response: { "currentStep": 1, "completedAt": null }

When currentStep reaches the total steps, the session is marked complete and a webhook fires.

FAQ

How do multi-step flows work?

Define a flow with a JSON steps array. Each PATCH call to the public API advances the session by one step, merging the step payload. When currentStep >= steps.length, the session is marked complete.

Is NexusKit Onboarding free?

Yes, within fair-use limits: 5,000 onboarding sessions per month, 120 requests per minute.

Can I trigger actions on completion?

Yes. Configure webhook endpoints in the dashboard. The onboarding.completed event fires with the full session payload when a flow finishes.

How does Turnstile work with multi-step?

Turnstile is only verified on step 0 (session creation). Subsequent steps do not require captcha.

Can I collect different data per step?

Yes. Each step has its own payload structure. The session accumulates all step payloads into a single JSON object.

Ready to build onboarding flows?

Start free. No credit card. Set up your first flow in minutes.

Create free accountAPI docs