🎯 Free Trial

Know exactly who's visiting your site — person-level ID in 174+ countries. Start free, no card needed.

Start free trial →

Embedded screens · Developer guide

Show our lead screens inside your own app

Your menu on the left, our Leads, pixel install and more on the right, in an iframe. Your users sign in to your app only, your server opens each session, and nothing secret ever reaches the browser. Live in a day.

Three ways to integrate. This guide covers embedded screens.

Not sure it's the right one? Compare them below. For API only or a full white label, talk to us and we'll walk you through it.

CompareAPI onlyEmbedded screens This guideFull white label
Where users workYour own screensYour app, our screens in a framereveal.yourdomain.com
Who signs users inYouYou (we never see their password)Our sign-in, your brand
You buildLeads list, pixel install, settingsOne server endpoint and an iframeYour marketing site and billing
Billing your clientsYoursYoursYours: your server calls our API on every payment
Time to launchWeeksA dayA few days (DNS + branding)
Step by step

How it works, step by step

Start with the one-time setup, then build the two scenarios. Click any row: it has everything you need, screenshots, code, cURL and Run. Your users only ever sign in to your app.

Run every call on this pageConnecting to the demo account…
Every API call, in orderClick any arrow: you get the call, a cURL to copy and a Run button.

The API calls of the chosen scenario, in order
Request to Happierleads Response Your own app (no Happierleads call)
Already have clients? Before you go live, run the one-off migration in One-time setup: it gives every client you already have a website, the same calls as Scenario 1, so they see their screens the first time they log in.

Try it

Pick a use case. The frame on the right is exactly what your users see (our read-only demo account; pixel checks are simulated, so any domain works).

Embed settings to preview (the same switches as Account settings → White label → Embed in your app)
Products
Features
app.youragency.com/visitors
Security

What runs on your server, what runs in the browser

A key in a web page can be read by anyone who opens it. So keys only ever live on your server, and the browser only ever gets a link that works once.

Keep it here

Your server only

  • Master API key master-priv-… acts as the account Owner.
  • Embed key hle_… can only open embedded sessions.
  • Creating, changing and deleting websites, setting leads and trials.
  • Asking for the one-time embed link, after your own sign-in check.
Fine to expose

Safe in the browser

  • The tracking pixel snippet: it only carries the website's public id.
  • The one-time embed link: it works once, within 60 seconds.
  • The messages the frame sends your page: ready, session-ended…
Don't

Never

  • A key in front-end code, a mobile app or a public repository.
  • DELETE /admin/websites/:id (or any write) from the browser: proxy it through your server after your own permission check.
  • One login shared between clients: one website and one client view each.

Try the API

Pick a call, change the request and press Send. Signed out, you see a sample response. Signed in, the call runs for real on your account with a one-hour token that only works here, kept in this page's memory (refresh and it's gone). Calls marked server only are never sent from a browser, even here.

Sign in at the top (or use the demo account) to run these calls for real.

Let Claude build it

Paste this into Claude (or any AI coding assistant) inside your app's code base. It builds every step on this page, the one-off migration included, and keeps a checklist file so nothing gets forgotten: the dashboard steps it asks you to confirm.

Prompt

Frequently Asked Questions

What is the Happierleads API?

A REST API that lets you integrate website visitor identification data into your own SaaS platform, CRM, or marketing tool — white-label, under your own branding.

Who is the Happierleads API for?

SaaS platforms, marketing tools, CRM vendors, and agencies who want to embed visitor intelligence without building the technology from scratch. Perfect for white-label and OEM use cases.

What data does the API return?

Company name, industry, size, and employee count. Where available: individual name, job title, email, phone, and LinkedIn profile — across 174+ countries.

Is there API documentation available?

Yes. Full API documentation, code samples, and webhook guides are included with your API partner setup. Contact us via the form on this page to get access.

How is API access priced?

API access is included on every plan. To offer it under your own brand, see white label (OEM).