---
title: "Create simple account"
method: POST
path: "/admin/simple/accounts/"
tags: ["Admin"]
---

# Create simple account

`POST /admin/simple/accounts/`

## Request body

- AdminSimpleAccountsCreateDTO — Batch simple-accounts create. ``accounts`` is a caller-keyed map of account entries. Each entry scaffolds one user with their own org → workspace → project graph. Per-account ``options`` override the top-level ``options`` defaults.
  - `options` AdminAccountCreateOptionsDTO
    - `dry_run` boolean, nullable
    - `idempotency_key` string, nullable
    - `create_identities` boolean, nullable
    - `create_api_keys` boolean, nullable
    - `return_api_keys` boolean, nullable
    - `seed_defaults` boolean, nullable
    - `reason` string, nullable
  - `accounts` object, required

## Response `200`

Successful Response

- AdminSimpleAccountsResponseDTO — Response for the simple batch endpoint (POST /simple/accounts/). ``accounts`` is keyed by the same refs used in the request so callers can look up each created account directly.
  - `accounts` object
  - `errors` AdminStructuredErrorDTO[], nullable
    - `code` string, required
    - `message` string, required
    - `details` object, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-16** `8b06b786c977` — 1 info
  - endpoint added
- **2025-06-27** `e3e84db47198` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/admin/simple/accounts/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/c469c2f6cdba/schema)