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

# Create Identity

`POST /v2/identities`

Endpoint to create an identity to issue credentials.
Issuer node supports two types of keys (field `type`):
* BJJ Keys
* ETH Keys

`credentialStatusType` field is optional and and defines how the auth core claim will be evaluated during 
the process to verify that it has not been revoked.

## Request body

- CreateIdentityRequest
  - `didMetadata` object, required
    - `method` string, required
    - `blockchain` string, required
    - `network` string, required
    - `type` 'BJJ' | 'ETH', required
  - `credentialStatusType` 'Iden3commRevocationStatusV1.0' | 'Iden3ReverseSparseMerkleTreeProof' | 'Iden3OnchainSparseMerkleTreeProof2023'
  - `displayName` string

## Response `201`

Identity created

- CreateIdentityResponse
  - `identifier` string
  - `displayName` string
  - `state` IdentityState
    - `stateID` integer, required
    - `identifier` string, required
    - `state` string
    - `rootOfRoots` string
    - `claimsTreeRoot` string
    - `revocationTreeRoot` string
    - `blockTimestamp` integer
    - `blockNumber` integer
    - `txID` string
    - `previousState` string
    - `status` string, required
    - `modifiedAt` string, required
    - `createdAt` string, required
  - `address` string
  - `balance` string
  - `keyType` string, required
  - `credentialStatusType` 'Iden3commRevocationStatusV1.0' | 'Iden3ReverseSparseMerkleTreeProof' | 'Iden3OnchainSparseMerkleTreeProof2023', required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Permission Denied
- `409` — Conflict
- `500` — Internal Server error

---

[API](https://skmtc.net/0xpolygonid/apis/privado-id-issuer.md) · [All operations](https://skmtc.net/0xpolygonid/apis/privado-id-issuer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/0xpolygonid/privado-id-issuer/revisions/8ea65174fe46/schema)