---
title: "Start Signup"
method: POST
path: "/api/v1/auth/signup"
tags: ["auth"]
---

# Start Signup

`POST /api/v1/auth/signup`

Route a freshly authenticated identity that has no MAIA account.

Rate Limited: 5 requests per minute per IP address.

Authenticated, but exempt from the terms gate — an account this new has
accepted nothing, and the gate would refuse the very request that creates
the account it would gate. Suspension is still enforced.

A POST rather than a side effect on the profile read: this creates an
account and sends mail, which a GET must never do.

## Response `200`

Successful Response

- SignupResponse — Where a signup ended up. ``account_id`` is absent for the two outcomes that create no account — an address that already has one, and one still waiting on its verification link.
  - `status` 'admitted' | 'waitlisted' | 'preparing' | 'verification_required' | 'already_registered', required
  - `account_id` string, uuid, nullable

---

[API](https://skmtc.net/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.net/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/revisions/136e4af4d514/schema)