---
title: "Create Identity"
method: POST
path: "/v1/secrets/identities"
tags: ["secrets"]
---

# Create Identity

`POST /v1/secrets/identities`

## Request

- Base URL: `https://api.cybret.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cybret.ai/v1/secrets/identities`
- Auth: HTTP bearer

## Request body

- CreateIdentityProfileRequest
  - `target_id` string, required
  - `kind` 'regular' | 'second_same_role' | 'cross_tenant' | 'admin' | 'anonymous', required
  - `display_name` string, required
  - `role_label` string, nullable
  - `secret_bindings` object
  - `auth_spec` IdentityAuthSpec: Value-free runtime recipe that turns an onboarded identity into an AuthProfile.
    - `verify_url` string, nullable
    - `verify_method` 'GET' | 'HEAD' | 'POST'
    - `expected_status` integer
    - `session_oracle` boolean
    - `provider` 'static' | 'scripted-login' | 'email-challenge' | 'http-login' | 'gotrue-refresh' | 'firebase-refresh' | 'clerk-refresh' | 'sso-login' | 'agent-generated'
    - `runtime_identity_id` string, nullable
    - `tenant_label` string, nullable
    - `journey` string, nullable
    - `token_endpoint` string, nullable
    - `signup_url` string, nullable
    - `refresh_secret_slot` string
    - `password_secret_slot` string
    - `api_key_secret_slot` string, nullable
    - `max_refreshes` integer, nullable
    - `email_challenge` object, nullable
    - `http_login` object, nullable
    - `display_username` string, nullable
    - `sso_provider` 'google' | 'microsoft', nullable
    - `pool_source` 'managed' | 'customer' | 'hand', nullable
    - `tenant_slot` 'A' | 'B', nullable
    - `matrix_role` 'owner' | 'peer', nullable
    - `peer_of` string, nullable

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cybret/apis/api-scanner-control-plane.md) · [All operations](https://skmtc.dev/cybret/apis/api-scanner-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/cybret/apis/api-scanner-control-plane/revisions/4c9b522246af?raw)