---
title: "Create a new account"
method: POST
path: "/v1/accounts"
tags: ["Accounts"]
---

# Create a new account

`POST /v1/accounts`

## Request

- Base URL: `https://api.honkio.ca`
- URL: `https://api.honkio.ca/v1/accounts`
- Auth: none required

## Request body

- object
  - `name` string, required
  - `email` string, email, required
  - `password` string, required: Account password (required, min 10 chars)
  - `terms_accepted` unknown, required
  - `terms_version` string, required: The Terms' "last updated" date the signer saw, YYYY-MM-DD (required).

## Response `201`

Account created in PENDING_PAYMENT, with no API keys. Sign in to the dashboard and create one on API Keys, where the raw key is shown once.

- object: Account created in PENDING_PAYMENT, with no API keys. Sign in to the dashboard and create one on API Keys, where the raw key is shown once.
  - `account` Account, required: An account, as signup and PATCH /v1/accounts/{id} return it.
    - `id` string, required
    - `name` string, required
    - `email` string, required
    - `stripe_customer_id` string, nullable, required
    - `email_verified_at` string, date-time, nullable, required
    - `status` 'PENDING_PAYMENT' | 'ACTIVE' | 'SUSPENDED' | 'CLOSED', required
    - `balance_cents` integer, required: Credit balance in cents CAD.
    - `verified_phone` string, nullable, required
    - `phone_verified_at` string, date-time, nullable, required
    - `email_undeliverable` boolean, required: True when platform email to this address is bouncing or being marked as spam.
    - `email_undeliverable_at` string, date-time, nullable, required: The bounce or complaint that made the address unreachable.
    - `email_undeliverable_reason` string, nullable, required: BOUNCE or COMPLAINT.
    - `terms_accepted_at` string, date-time, nullable, required: When the owner accepted the Terms of Service and Privacy Policy.
    - `terms_version` string, nullable, required: The Terms version (last-updated date) that was accepted.
    - `created_at` string, date-time, required

## Other responses

- `409`: CONFLICT: an account already uses this email.
- `422`: VALIDATION_ERROR: the request failed validation; details names the fields.
- `429`: RATE_LIMITED: 5 signups per hour from one address.
- `503`: SERVICE_UNAVAILABLE: new registrations are paused.

---

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