---
title: "Self-serve signup: email in, live free-tier API key out (no auth required)"
method: POST
path: "/v1/signup"
---

# Self-serve signup: email in, live free-tier API key out (no auth required)

`POST /v1/signup`

## Request

- Base URL: `https://swathapi.com`
- URL: `https://swathapi.com/v1/signup`
- Auth: none required

Creates a free-tier account (2 trial credits) and returns a live API key. The api_key value is shown exactly once — only its hash is stored, so it must be saved immediately. Rate limited to 3 signups per IP per 24h.

## Request body

- object
  - `email` string, required: Account email (one account per email)
  - `name` string: Optional account name

## Response `201`

Account created — api_key appears only in this response

- SignupResult
  - `account_id` string
  - `plan` 'free'
  - `monthly_credits` number
  - `api_key` string: Live API key (sk_live_...) — shown exactly once, save it immediately
  - `docs` string
  - `quickstart` string: Ready-to-run curl command using the new key

## Other responses

- `400`: A valid email is required
- `409`: An account with this email already exists
- `429`: Signup rate limit (3 per IP per 24h)

---

[API](https://skmtc.dev/swathapi/apis/swath-api.md) · [All operations](https://skmtc.dev/swathapi/apis/swath-api/llms.txt) · [OpenAPI document](https://skmtc.dev/swathapi/apis/swath-api/revisions/7dbea40372ef?raw)