---
title: "Create an AgentTax account + agent"
method: POST
path: "/api/v1/auth/signup"
tags: ["Auth"]
---

# Create an AgentTax account + agent

`POST /api/v1/auth/signup`

## Request

- Base URL: `https://www.agenttax.io`
- URL: `https://www.agenttax.io/api/v1/auth/signup`
- Auth: none declared

Creates an entity, an agent, and an API key in one call. Returns the API key once — save it. Cookie-based session also issued (HttpOnly atx_session + readable atx_csrf).

## Request body

- SignupRequest
  - `email` string, email, required
  - `password` string, required
  - `agent_name` string, required
  - `agent_description` string
  - `agent_work_type` 'compute' | 'research' | 'information_service' | 'content' | 'consulting' | 'trading' | 'payment_processing' | 'web_hosting' | 'software_maintenance' | 'it_support' | 'custom_software', required
  - `company_name` string
  - `state` string: Two-letter US state code (or empty string).
  - `ein` string: 9-digit US EIN. Stored AES-256-GCM encrypted at rest.
  - `est_volume` string
  - `join_network` boolean
  - `network_visibility` 'public' | 'private'
  - `utm` UtmAttribution
    - `utm_source` string
    - `utm_medium` string
    - `utm_campaign` string
    - `utm_content` string
    - `utm_term` string
    - `landing_page` string

## Response `201`

Account created.

## Other responses

- `400`: Validation failure
- `409`: Email already registered
- `503`: EIN provided but encryption misconfigured (fail-closed)

---

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