Dashboard Guide

The dashboard is your control center for managing identities, monitoring events, and configuring your project. This guide walks through every panel and its capabilities.

Overview

The AIdenID dashboard is organized into panels, each focused on a specific capability. You can access the dashboard after logging in at aidenid.com/login. The sidebar navigation gives you quick access to every panel described below.

Identity Provisioning

The provisioning panel lets you create new disposable email identities directly from the dashboard. Fill in:

• Label — A human-readable name for the identity (e.g., "github-signup-test")
• Custom domain (optional) — Select a verified domain to use instead of the default inbox.aidenid.com
• TTL in hours — How long the identity should remain active before expiring
• Metadata (optional) — Key-value pairs for your own tracking (e.g., agent name, flow type, correlation ID)

The identity gets a unique inbox address immediately after creation. Use this panel for manual testing or one-off identity creation. For automation, use the API directly.

Identity Lifecycle

The lifecycle panel shows all your identities with their current status:

• Provisioned — Created, not yet received mail
• Active — Has received inbound email
• Extended — TTL was extended beyond original duration
• Squashed — Manually revoked
• Expired — TTL has elapsed

Filter by status to find specific identities. Click any identity to see its full event history, extraction results, and metadata. From the detail view you can extend the TTL, squash the identity, or copy the inbox address.

See Identity Lifecycle for details on state transitions and TTL policies.

Inbound Inbox

The inbound inbox is a real-time feed of email events arriving at your identities. Each event shows:

• Sender address and subject line
• Which identity received the email
• Extraction results (OTP, magic link, or confirmation link)
• Extraction confidence score

Events appear via SSE (Server-Sent Events) — no page refresh needed. Each event links to the identity detail view where you can see the full email body and extraction confidence scores.

Auth Flow Testing

The auth flow testing panel lets you test signup, password-reset, and invite flows against target URLs. The system:

1. Provisions a temporary identity
2. Submits the identity email to the target service
3. Monitors the inbox for verification emails
4. Extracts and reports the result

Results include:

• Success/failure rate — Did the target service send a verification email?
• Time to receive OTP — How long between form submission and email arrival
• Extraction confidence — How certain the system is about the extracted value

This is useful for monitoring third-party email delivery reliability over time. Run tests on a schedule to catch delivery regressions before your users do.

Domain Management

Register custom domains so your identities use branded email addresses (e.g., temp@yourdomain.com instead of random@inbox.aidenid.com). The domain management panel shows:

• DNS records — The MX and TXT records you need to configure with your DNS provider
• Verification status — Whether AIdenID has confirmed your DNS configuration

Once a domain is verified, it becomes available for all identity creation — both through the dashboard and the API. You can register multiple domains depending on your plan.

Webhook Configuration

Set up HTTP endpoints to receive real-time event notifications instead of polling the API. Supported event types:

• extraction.completed — A code or link was extracted from an email
• identity.created — A new identity was provisioned
• identity.expired — An identity TTL elapsed
• inbound.received — An email arrived at an identity inbox

Each webhook payload is HMAC-signed with a secret that you can rotate at any time. The configuration panel also lets you:

• View delivery history for each endpoint
• Replay failed deliveries
• Test endpoints with sample payloads

See Webhook Integration for payload formats and signature verification.

Lineage & Budget

The lineage and budget panel gives you visibility into two things:

• Identity budget — Your active identity count vs your plan limit. A visual bar shows how much capacity remains.
• Lineage trees — Visual representation of parent-child identity relationships. Useful when using child identities for multi-step verification flows (e.g., a primary email and a recovery email for the same signup).

Click any node in a lineage tree to jump to that identity's detail view.

Settings

Project configuration is managed from the settings panel. All settings are scoped to your current project:

• API keys — Create, rotate, and revoke API keys. Each key shows its creation date, last used timestamp, and scopes.
• Webhook secrets — Manage HMAC signing secrets for webhook payload verification.
• Default TTL — Set a project-wide default TTL for new identities (applied when no ttl_hours is specified).
• Metadata templates — Define reusable metadata key-value templates for consistent identity tagging.

Admin

The admin panel is restricted to platform owners and provides abuse and reliability operations:

• Runtime error stream — Live feed of 5xx and 429 errors with request IDs and trace IDs for debugging
• Abuse circuit breakers — Bulk squash operations and domain freeze/unfreeze controls
• Legal hold controls — Place and remove legal holds on identities to prevent data destruction during review
• Support access grants — Grant temporary access to support staff with ticket-bound TTLs that auto-expire
• Audit timeline — Complete audit log of all admin actions with actor, timestamp, and affected resources
• Incident recommendations — AI-generated recommendations based on error patterns and abuse signals
• Incident timeline export — Export incident data for post-mortems and compliance reporting

Related

• Identity Lifecycle
• Webhook Integration
• Identities API
• Abuse Prevention