---
title: "Create an account and get an API key at once (accepts the terms)"
method: POST
path: "/api/v1/signup"
---

# Create an account and get an API key at once (accepts the terms)

`POST /api/v1/signup`

## Request

- Base URL: `https://uidwatch.tollwyn.com`
- URL: `https://uidwatch.tollwyn.com/api/v1/signup`
- Auth: none required

## Request body

- object
  - `email` string, email, required
  - `via` string: Optional partner id: lower-case words joined by hyphens
  - `accept_terms` true, required: Accepts the terms at https://uidwatch.tollwyn.com/terms, including the data processing terms in section 8, on behalf of the business that signs up.

## Response `201`

The account in its trial and its first API key (shown only here). The trial allows 20 entries until a person confirms the email address.

- object
  - `api_key` string, required
  - `account` Account, required
    - `id` string, uuid, required
    - `email` string, required
    - `email_verified` boolean, required
    - `plan` 'trial' | 'monitor' | 'paused', required: monitor: a subscription; paused: trial or subscription ended
    - `monitoring` boolean, required: Whether the list is compared with the gazette
    - `limit` integer, required: Entries the plan monitors
    - `usage` integer, required: Entries on the list
    - `trial_ends_at` string, date-time, required
    - `last_scan_at` string, date-time, nullable, required: Last successful check of the gazette; null for a few minutes after a restart
    - `created_at` string, date-time, required

## Other responses

- `400`: The body is not JSON (invalid_json).
- `409`: An account with this email exists (email_taken).
- `422`: The body is not valid, for example accept_terms is not true (invalid_request).
- `429`: Too many requests (rate_limited); see the Retry-After header.

---

[API](https://skmtc.dev/tollwyn/apis/uidwatch-api.md) · [All operations](https://skmtc.dev/tollwyn/apis/uidwatch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tollwyn/apis/uidwatch-api/revisions/198aa0efb0f6?raw)