Agent Onboarding API: Sign Up, Pay & Get Your API Token Without Leaving the Terminal

Until now, using the Humblytics API meant signing up on the website, navigating the dashboard, and manually copying an API key. That workflow makes sense for humans — but it breaks the moment an AI agent is doing the work.

Today we're launching the Agent Onboarding API — a two-step flow that lets agents create accounts, handle payment, and receive a ready-to-use auth token without the user ever touching a dashboard.

Why This Matters

The best agent experiences are seamless. When a user tells their agent "set up analytics for my site," they don't want to context-switch to a browser, create an account, find settings, and paste a key back into the terminal. They want the agent to handle it.

The Agent Onboarding API makes that possible. The entire flow — signup, identity verification, plan selection, Stripe payment, and token delivery — happens in a single conversation between the user and their agent.

How It Works

The flow has three parts: the agent initiates, the user verifies, and the agent receives the token.

Step 1 — Agent initiates signup

The agent calls a single endpoint with the user's email and name:

POST https://app.humblytics.com/api/v1/auth/agent-initiate
Content-Type: application/json

{ "email": "[email protected]", "name": "Jane Smith" }

The response includes a unique verification URL and a session token:

{
  "token": "<session-token>",
  "verifyUrl": "https://app.humblytics.com/agent-verify?token=<session-token>",
  "expiresAt": 1234567890000
}

If the email already has an account, the API returns 409 with { "error": "user_exists" } so the agent can handle it gracefully.

Step 2 — User opens the verification link

The agent presents the URL to the user. When they open it in their browser, the page:

1. Silently verifies the user is human
2. Creates their Humblytics account
3. Asks them to choose Business Monthly ($79/mo) or Business Annual ($65/mo)
4. Redirects to Stripe for payment
5. Shows a confirmation page

The entire browser flow takes under a minute.

Step 3 — Agent polls and receives the token

While the user is in the browser, the agent polls every 3–5 seconds:

GET https://app.humblytics.com/api/v1/auth/agent-signup-status?token=<session-token>

Once the user completes payment, the response includes a JWT auth token:

{
  "status": "complete",
  "authToken": "<jwt>"
}

The token is delivered once — the session is deleted after this response. The agent stores it and uses it as a Bearer token for all subsequent API calls.

What Comes Next: Add a Website

With the token in hand, the agent can immediately add a website:

POST https://app.humblytics.com/api/v1/add-custom-site
Authorization: Bearer <authToken>
Content-Type: application/json

{ "domain": "example.com", "name": "My Site" }

The response includes a scriptId that the agent can use to install the tracking script:

<script async src="https://app.humblytics.com/hmbl.min.js?id=<script-id>"></script>

From there, the agent has full access to the Humblytics API — analytics data, split test recommendations, experiment creation, funnel analysis, and more.

Open the Docs in Your Editor

We've published the full onboarding spec as a markdown file that agents can consume directly:

https://app.humblytics.com/agent.md

You can also open it directly in your editor:

• Cursor: Add to Cursor — opens Cursor and creates a rule from the spec
• Claude Code: Run curl -o HUMBLYTICS.md https://app.humblytics.com/agent.md to download, then include in your CLAUDE.md

Add the spec to your CLAUDE.md, .cursorrules, or system prompt and your agent will know how to onboard new users automatically.

Quick API Reference

| Step | Method | Endpoint | |------|--------|----------| | Initiate signup | POST | /api/v1/auth/agent-initiate | | Poll for completion | GET | /api/v1/auth/agent-signup-status?token=<token> | | Add a website | POST | /api/v1/add-custom-site | | List websites | GET | /api/v1/property/all | | Billing status | GET | /api/v1/billing/status |

The Bigger Picture

This is part of our push to make Humblytics fully agent-native. We already have endpoints for reading analytics data, generating A/B test recommendations, and launching experiments programmatically. The onboarding API closes the last gap — agents can now handle the entire lifecycle from first signup to running optimizations, without the user ever opening a dashboard.

The agent web is here. Build for it.