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

# Create user identities

`POST /admin/simple/accounts/users/identities/`

## Request body

- AdminSimpleAccountsUsersIdentitiesCreate
  - `options` AdminAccountCreateOptions
    - `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
  - `user_ref` EntityRef, required — Polymorphic reference that can point to a request-local key, an existing persisted ID, a stable slug, or an email address. Exactly one field must be set.
    - `ref` string, nullable
    - `id` string, nullable
    - `slug` string, nullable
    - `email` string, nullable
  - `user_identity` AdminUserIdentityCreate, required
    - `user_ref` EntityRef — Polymorphic reference that can point to a request-local key, an existing persisted ID, a stable slug, or an email address. Exactly one field must be set.
      - `ref` string, nullable
      - `id` string, nullable
      - `slug` string, nullable
      - `email` string, nullable
    - `method` string, required
    - `subject` string, required
    - `domain` string, nullable
    - `email` string, nullable
    - `password` string, nullable
    - `verified` boolean, nullable
    - `provider_user_id` string, nullable
    - `claims` object, nullable

## Response `200`

Successful Response

- AdminAccountsResponse
  - `accounts` AdminAccountRead[]
    - `users` object
    - `user_identities` object
    - `organizations` object
    - `workspaces` object
    - `projects` object
    - `organization_memberships` object
    - `workspace_memberships` object
    - `project_memberships` object
    - `subscriptions` object, nullable
    - `api_keys` object, nullable
  - `errors` AdminStructuredError[], nullable
    - `code` string, required
    - `message` string, required
    - `details` object, nullable

## Other responses

- `422` — Validation Error

---

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