Agent signup

Verify the signup inbox, then build in sandbox.

Use the email supplied to the account-intents API. It can be a human inbox or an authorized agent inbox; live billing and card setup stay gated.

What address.bot verifies

Start with one simple job: prove that a real address can receive mail. Start in sandbox; live mail and spend require explicit approval.

Agent signup API

Let software start setup while the owner controls live mail

The public account-intents endpoint exists for agent discovery and setup. It records the signup inbox, business name, webhook target, and intended operating mode, then sends that inbox back into this signup page to verify email and apply the setup.

1. Agent posts an account intent.
2. Signup inbox opens the secure link and verifies email.
3. Business details are applied to the workspace.
4. Verified user creates the first sandbox key and completes setup.
5. Agent uses the issued keys for preflight, create, logs, and webhook flows.

Account intent example

curl -X POST https://address.bot/api/v1/account-intents \
  -H "content-type: application/json" \
  -d '{
    "owner_email": "owner@company.com",
    "business_name": "Northline Mail Ops",
    "onboarding_intent": "agent_api",
    "primary_use_case": "Mail QR postcards and verify six-digit access codes.",
    "webhook_url": "https://agents.example.com/addressbot/webhooks"
  }'

The response includes an `id` and `login_url`. After the owner verifies email, normal sandbox keys, live keys, billing controls, and webhooks take over.