Verify Your Corbado Observe Integration

After deploying Autocapture or adding custom events, confirm that the agreed journeys arrive with the expected steps and outcomes.

For a browser evaluation, verify delivery under Events in the management console. Observe requests sent through the extension transport may not appear in the page’s Network panel or the Observe Debugger.

1. The three tools

Tool	Use it for
Debug mode	Set `debug: true` at initialization and Observe logs every tracked event to the console. Fastest check that a call site fires at all.
Corbado Observe Debugger	A Chrome DevTools extension with a filterable live stream of what actually leaves the browser, plus the current session ID and user references. Works for both Autocapture and custom events.
Management console	Confirms events were accepted and modeled correctly. Use the events view for the raw stream and user search to reconstruct one journey end to end.

For Autocapture, Observe → Settings → Autocapture also shows whether events from your pages are arriving.

2. Walkthrough

Walk each journey

Walk the journeys included in your integration scope, such as login, sign-up, recovery or enrollment. For Autocapture, confirm this scope with Corbado.

Confirm the events

With debug mode or the Observe Debugger extension open, check that each completed journey produces the expected flow boundaries, decisions, steps and outcome. For Autocapture, review these with Corbado; for custom events, compare them against your event calls. Duplicates from re-renders and a missing finish before a redirect are the two most common defects. Compare against the journey catalog.

Check one journey in the console

Find a test journey via user search and confirm the flow, subflows and decisions look the way you expect.

Check a failure

Test a failure or cancellation in scope, such as an incorrect password or a cancelled passkey dialog. Confirm that the recorded steps and outcome reflect what happened, including attempts that ended before a backend request.

Check identifier attribution when enabled

Submit the same test identifier from two devices and fail both logins. Confirm identifier search finds both attempts without treating them as authenticated activity. Then test changing the identifier or authenticating as a different test user. Check that submissions remain visible and only supported identifier-to-user links are created. See the visual scenarios.

3. When data appears

Data appears in stages. Raw events are visible in the console’s events view right after ingestion. Flows, decisions and subflows appear after the next classification run, which happens about a minute later. Funnels and charts refresh with the next pre-calculation run, a few minutes after that. If a journey is missing from a chart but present in the events view, wait before debugging.

4. Common issues

Symptom	Likely cause
No events at all	Script not loaded, wrong `Project ID` or `API Base URL` or a Content Security Policy blocking the script or the API endpoint
Events arrive but no WebAuthn detail	The SDK is not running in the frame that performs the ceremony. See Iframes and RP IDs
Journeys break in the middle	The SDK initializes too late, pages use different project IDs, or a reload starts a new session after inactivity. Check session lifetime and the project’s continuity configuration
Journeys from different environments mixed	Production and staging share a project. Use separate projects per environment
Events arrive, but the whole session has no flows	A `flowFinished()` or `flowDecided()` fired without an open flow. That invalidates the session’s classification. See ordering
A nested sign-up or recovery shows as incomplete although the user finished it	The outer flow’s `flowStarted()` fired again while the nested flow was open, for example from a remounted route. See flows
A decision is missing although both events fired	The `explicitDecisionValue` is not one of the declared `options`, or `finished` carried a different options array. See decisions
A passkey attempt is missing	No `explicitSpecType` arrived on any of its events. See spec types

Overview

Get started

Custom events

Developer tools

Data access

Security & compliance

Custom events reference

Verify Your Corbado Observe Integration

1. The three tools

2. Walkthrough

3. When data appears

4. Common issues

5. Next steps

Corbado Observe Debugger

Tracking reference

​1. The three tools

​2. Walkthrough

​3. When data appears

​4. Common issues

​5. Next steps

Corbado Observe Debugger

Tracking reference

1. The three tools

2. Walkthrough

3. When data appears

4. Common issues

5. Next steps