---
title: "Create Credential"
method: POST
path: "/v2/identities/{identifier}/credentials"
tags: ["Credentials"]
---

# Create Credential

`POST /v2/identities/{identifier}/credentials`

## Request

- The document declares no server URL.
- Auth: HTTP basic

Creates a credential for the provided identity.

## Path parameters

- `identifier` string, required

## Request body

- CreateCredentialRequest
  - `credentialSchema` string, required
  - `claimID` string
  - `type` string, required
  - `credentialSubject` object, required
  - `expiration` integer
  - `version` integer
  - `revNonce` integer
  - `subjectPosition` string
  - `merklizedRootPosition` string
  - `refreshService` RefreshService
    - `id` string, required
    - `type` 'Iden3RefreshService2023', required
  - `displayMethod` DisplayMethod
    - `id` string, required
    - `type` 'Iden3BasicDisplayMethodV1', required
  - `proofs` string[]
  - `credentialStatusType` 'Iden3commRevocationStatusV1.0' | 'Iden3ReverseSparseMerkleTreeProof' | 'Iden3OnchainSparseMerkleTreeProof2023'
  - `encryptionKey` object

## Response `201`

Credential Created

- CreateCredentialResponse
  - `id` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `422`: Unprocessable Content
- `500`: Internal Server error

## Changes

- **2025-10-13** `04191088c904`: 1 info
  - added the new optional request property `encryptionKey`
- **2024-12-18** `fe16b051b34c`: 1 breaking, 1 info
  - removed the enum value `Iden3BasicDisplayMethodv2` of the request property `displayMethod/type`
  - added the new `Iden3BasicDisplayMethodV1` enum value to the request property `displayMethod/type`
- **2024-12-18** `c211b9b15a5d`: 1 breaking, 1 info
  - removed the enum value `Iden3BasicDisplayMethodV1` of the request property `displayMethod/type`
  - added the new `Iden3BasicDisplayMethodv2` enum value to the request property `displayMethod/type`
- **2024-12-17** `96ff718e8ae9`: 1 breaking, 1 info
  - removed the enum value `Iden3BasicDisplayMethodv2` of the request property `displayMethod/type`
  - added the new `Iden3BasicDisplayMethodV1` enum value to the request property `displayMethod/type`
- **2024-12-02** `a71b9e9bd838`: 1 breaking, 1 warning, 1 info
  - removed the enum value `Iden3BasicDisplayMethodV1` of the request property `displayMethod/type`
  - removed the request property `encryptionKey`
  - added the new `Iden3BasicDisplayMethodv2` enum value to the request property `displayMethod/type`

[Operation history](https://skmtc.dev/0xpolygonid/apis/privado-id-issuer/changes/v2/identities/:identifier/credentials/post.md)

---

[API](https://skmtc.dev/0xpolygonid/apis/privado-id-issuer.md) - [All operations](https://skmtc.dev/0xpolygonid/apis/privado-id-issuer/llms.txt) - [OpenAPI document](https://skmtc.dev/0xpolygonid/apis/privado-id-issuer/revisions/8ea65174fe46?raw)