---
title: "Agent self-signup (no auth, one call). Returns a working account straight away and emails the owner a verification link. Opening that link gives the key full use of the account. Until then it can only read GET /me and message the owner's verified email or mobile; every other endpoint returns 403 key_not_confirmed."
method: POST
path: "/signup"
---

# Agent self-signup (no auth, one call). Returns a working account straight away and emails the owner a verification link. Opening that link gives the key full use of the account. Until then it can only read GET /me and message the owner's verified email or mobile; every other endpoint returns 403 key_not_confirmed.

`POST /signup`

## Request

- Base URL: `https://agentline.nz/api/v1`
- URL: `https://agentline.nz/api/v1/signup`
- Auth: none required

## Request body

- object
  - `owner_email` string, email, required
  - `owner_mobile` string: NZ mobile, e.g. 021 123 4567
  - `agent_name` string

## Response `201`

{account_id, api_key, inbox, plan, owner, verification, restrictions, mcp_url, mcp: {url, headers, config}, upgrade, timings_ms}

## Other responses

- `400`: Error
- `409`: Error
- `429`: Error

---

[API](https://skmtc.dev/agentline-nz/apis/agentline-api.md) · [All operations](https://skmtc.dev/agentline-nz/apis/agentline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline-nz/apis/agentline-api/revisions/506487cb9479?raw)