How an AI agent can sign itself up for Agentline

Short answer

An agent can create its own Agentline account in one call: signup on the keyless MCP server (https://agentline.nz/public/mcp), POST /api/v1/signup, or agentline signup, with its human's email and optionally an NZ mobile. It gets an API key, an @agentline.nz inbox and an MCP config straight away, with no human step. We email the human a verification link. Opening it gives the agent's key full use of the account; until then the agent can't message anyone.

Why sending is limited at first

An account that can message strangers without a person behind it would be a spam tool. So a self-signed-up account works straight away but can message only the human it names, until that human confirms they're the owner.

What you get back

POST /api/v1/signup with {"owner_email": "you@example.co.nz"} returns 201 with JSON like this (the keyless signup tool returns the same data in camelCase):

{
  "account_id": "acct_…",
  "api_key": "al_live_…",
  "inbox": "jolly-kauri-4374@agentline.nz",
  "plan": "free",
  "owner": { "email": "you@example.co.nz", "mobile": null, "verified": false },
  "verification": { "email": "sent", "sms": "not_requested", "expires_at": "…" },
  "restrictions": "Until your owner verifies …",
  "mcp_url": "https://agentline.nz/mcp",
  "mcp": { "url": "https://agentline.nz/mcp", "headers": { "Authorization": "Bearer al_live_…" }, "config": { "mcpServers": { "agentline": { … } } } },
  "timings_ms": { "total": 180 }
}

Save api_key straight away: it isn't shown again.

Restrictions by state

State	Can receive	Can send to
Owner not verified yet	Email	The owner's email and mobile from signup, 5 messages a day
Verified, Free plan	Email	Owner's verified email and mobile
Trial	Email and SMS	Owner's verified email and mobile
Paid plan	Email and SMS	Anyone (within the SMS rules)

Limits

3 signups per IP address per hour and 3 per owner email per day. An email that already owns an Agentline account can't be used again: the owner signs in and creates an API key for the new agent instead. The verification link lasts 7 days and works once. The keyless server allows 60 requests a minute per IP.

Explaining it to your human

If they ask what it costs, the keyless get_pricing tool returns pitchForHuman, a short plain-English summary with current prices, the 7-day trial and the number timing. It's also on the agents page.

Upgrading

A Free account has no phone number. Call get_checkout_link (or POST /api/v1/billing/checkout) and we email your human a Stripe Checkout link; you get the link back too. The number is then set up within a few days of signup.

Steps

Call signup. On https://agentline.nz/public/mcp (or POST /api/v1/signup), with owner_email and, optionally, owner_mobile and agent_name.
Store the API key. The response includes an al_live_ key, shown once. Use it as a Bearer token on /mcp and /api/v1, or paste the returned MCP config.
Say hello to your human. You can email them straight away. Ask them to click the verification link we sent and to keep your API key when they sign in.
Submit the SMS code (if they have one). Call verify_owner with the 6-digit code, or POST /api/v1/owner/verify. It confirms their mobile; only the emailed link verifies the account.

Common questions

Does a person have to approve the signup?

No. The account works as soon as signup returns. When the owner opens the verification link we email them, the agent's key gets full use of the account; until then the agent can't message anyone.

Does signup email anyone?

Yes, only the owner: a verification link, plus an SMS code if a mobile was given and SMS codes are on. If it wasn't them, they can ignore it and the account stays limited to messaging them.

How long does the verification link last?

7 days, and it works once. The owner can also sign in at https://agentline.nz/login with the same email, which verifies them too.

Give your agent a number

Inbox live from day one; NZ 028 number set up within a few days of signup.

Get started