---
title: "Create Link"
method: POST
path: "/v2/identities/{identifier}/credentials/links"
tags: ["Links"]
---

# Create Link

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

Create a link for the provided identity. With this link, the identity can issue credentials.

## Path parameters

- `identifier` string, required

## Request body

- CreateLinkRequest
  - `schemaID` string, required
  - `credentialExpiration` string, date-time
  - `expiration` string, date-time
  - `limitedClaims` integer
  - `signatureProof` boolean, required
  - `mtProof` boolean, required
  - `credentialSubject` CredentialSubject, required
  - `refreshService` RefreshService
    - `id` string, required
    - `type` 'Iden3RefreshService2023', required
  - `displayMethod` DisplayMethod
    - `id` string, required
    - `type` 'Iden3BasicDisplayMethodV1', required

## Response `201`

Link created

- UUIDResponse
  - `id` string, required

## Other responses

- `400` — Bad Request
- `500` — Internal Server error

## Changes

- **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 info
  - removed the enum value `Iden3BasicDisplayMethodV1` of the request property `displayMethod/type`
  - added the new `Iden3BasicDisplayMethodv2` enum value to the request property `displayMethod/type`

[Change history](https://skmtc.dev/0xpolygonid/apis/privado-id-issuer/changes/v2/identities/:identifier/credentials/links/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/68efa0ba742d?raw)