Onboarding

Last updated: July 30, 2026

Use onboarding after account verification and authentication to establish the account's first valid organization and Owner membership.

Important

The onboarding application contract and PostgreSQL-backed behavior are implemented and verified in the preview repository. The official generated UI and consumer package release are not yet published.

Start here

• Onboarding state — Decide whether verification or first-organization creation is required.
• Create the first organization — Complete the only organization-creation path exposed by the Initial MVP onboarding contract.
• Transactional onboarding — Understand the atomic state transition and rollback guarantees.

Common tasks

• Verify onboarding completion
• Customize the onboarding experience

Key concepts

Onboarding is not a consumer-defined workflow engine. The public contract exposes state discovery and one atomic completion operation. It does not expose arbitrary step mutation, skip operations, additional-organization creation, membership administration, or framework persistence.

Troubleshooting

Use operation errors and the returned correlation identifier. Do not inspect framework tables to infer partial completion; the supported transition is atomic.

Reference

The public surface consists of IOnboardingApplication, OnboardingState, CompleteFirstOrganizationCommand, and OnboardingCompletion in Trombetta.SaaS.Contracts.Identity.