---
title: "Create an account in pending_verify status; queue verification email"
method: POST
path: "/v1/signup"
tags: ["auth"]
---

# Create an account in pending_verify status; queue verification email

`POST /v1/signup`

## Request

- Base URL: `https://api.travelminds.ai`
- URL: `https://api.travelminds.ai/v1/signup`
- Auth: none declared

Registers a new account, queues an email-verification message into tmai_email_outbox (the worker dispatches within ~1 minute), and returns the new account_id. billing_country is ISO-3166 alpha-2 — used by checkout when BILLING_PROVIDER_MODE='country' (currently 'paddle' by default, see /v1/checkout).

## Request body

- SignupBody
  - `email` string, email, required
  - `password` string, required
  - `name` string, nullable
  - `organisation_name` string, nullable
  - `billing_country` string, required
  - `signup_plan_intent` string, nullable
  - `signup_cycle_intent` string, nullable

## Response `201`

Successful Response

- SignupResponse
  - `account_id` string, required
  - `email` string, required
  - `email_verification` string

## Other responses

- `422`: Validation Error

---

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