OneHazel Docs

Appearance

For LLMsView as Markdown·

In-App Onboarding ​

Walk through what happens from signup to your first connected integration in the OneHazel dashboard.

Prefer to integrate programmatically? See the Getting Started guide, which works directly against the OneHazel application programming interface (API), instead.

1. Sign Up ​

Head to app.onehazel.com and click Create Account. You'll see a single form asking for:

  • Your name
  • Company name
  • Email address
  • Password (at least 6 characters)

The account type is set to Operator. Platform and Supplier roles are not part of self-serve signup; contact us if you need one.

2. Verify Your Email ​

After submitting, you'll land on a "Check your inbox" page. Click the verification link in the email to activate your account.

When you return and sign in, your registration completes automatically, no second form needed.

3. Your Account Is Active ​

A self-serve account is active as soon as you verify your email: there is no approval wait. If a teammate invited you to their team, your account is active as soon as you accept the invitation. If a OneHazel admin created your account for you, it waits until that admin approves it.

Need help? Once you are signed in, use the chat button in the OneHazel app.

4. The Onboarding Wizard ​

On your first sign-in once your account is active, a 7-step wizard appears. Each step validates itself against the OneHazel backend before you move forward, so you can't finish with a broken setup.

Step 1: Welcome ​

Pick your industry (iGaming, FinTech, eCommerce, SaaS, or Custom) and confirm your company name. Your industry choice tailors the rest of the wizard: the connector recommendations, data template, and sample data all adjust accordingly.

Step 2: Generate Your API Key ​

Click Generate API Key and copy the oh_live_... token shown. This is the only time it's displayed. Save it in your password manager or secret store immediately.

The wizard makes a test call with your new key to verify it works before letting you proceed.

Step 3: Connect Your First Integration ​

The wizard shows a short list of recommended connectors for your industry, rather than the whole marketplace. Pick one, enter your credentials, and hit Test Connection.

  • A green check means credentials verified against the live provider
  • A red X means you can fix them inline or activate anyway (at your own risk)

Step 4: Configure Your Data Lake ​

Select a data template that matches your industry. For iGaming, the default tpl_igaming template defines:

  • Entity types: player, operator, game
  • Event types: transaction, game_activity, session, bonus, block, support, affiliate
  • State keys: balance, kyc_status, risk_score, loyalty_tier
  • PII fields: automatically encrypted at rest (first_name, last_name, email, etc.)

You can also seed sample data so your dashboard isn't empty when you first log in.

Step 5: Set Up Webhooks ​

Provide a URL where OneHazel can POST events (e.g. https://your-platform.com/webhooks/onehazel). The wizard fires a test event and verifies your endpoint responded with a 2xx.

All webhook deliveries are signed with HMAC-SHA256. See Webhooks for signature verification.

Step 6: Verification ​

A 5-check health dashboard runs:

  1. Operator profile active ✓
  2. API key working ✓
  3. At least one connector configured ✓
  4. Data template applied ✓
  5. Webhook subscription verified ✓

Any failures link back to the relevant step so you can fix them.

Step 7: Completion ​

Summary of what you set up, links to the Analytics dashboard, and your next-step recommendations (e.g. "build your first workflow").

5. You're Live ​

After the wizard, you land in the main Operator Shell with these sections:

  • Marketplace: the full connector catalogue
  • Connections: manage your integrations (edit credentials, test, disconnect, delete)
  • Workflows: visual workflow builder for automating actions
  • Analytics: KPIs, revenue, player/user metrics
  • Account → Team: invite teammates and manage their roles (see Team Management)
  • Settings: API keys, data templates, webhooks

Skipping the Wizard ​

You can skip individual wizard steps if you'd rather set them up later via the API or Settings pages. The wizard only blocks on Welcome and Completion.

What's Next? ​