---
title: "Create identity"
method: POST
path: "/api/v2/identities"
tags: ["Identities"]
---

# Create identity

`POST /api/v2/identities`

## Request

- Base URL: `https://app.didlogic.com`
- URL: `https://app.didlogic.com/api/v2/identities`
- Auth: HTTP bearer

Create a new identity for document organization.

**Required Fields:**
- name - Identity name

`identity.id` feeds documents_index, documents_create, documents_update, identities_destroy and
numbers_purchase_update. Rows: identities_index.

## Request body

- object
  - `identity` object
    - `name` string: Identity name

## Response `200`

creates a new identity

- object
  - `message` string, required: Success message
  - `identity_id` integer, required: Created identity ID
  - `identity` object, required: Created identity details
    - `id` integer, required: Identity identifier
    - `name` string, required: Identity name
    - `user_id` integer, required: Owner user ID
    - `created_at` string, required
    - `persistence_status` string, required
    - `is_default` boolean, required
    - `documents_count` integer, required

## Other responses

- `401`: returns unauthorized
- `422`: returns unprocessable entity

---

[API](https://skmtc.dev/didlogic/apis/get-started.md) · [All operations](https://skmtc.dev/didlogic/apis/get-started/llms.txt) · [OpenAPI document](https://skmtc.dev/didlogic/apis/get-started/revisions/dc972d592b34?raw)