---
title: "Create a credential schema"
method: POST
path: "/v1/credential-schemas"
tags: ["Credentials"]
---

# Create a credential schema

`POST /v1/credential-schemas`

Create a credential schema for your tenant. You define the schema name, VCT (Verifiable Credential Type), and claim attributes. The API returns the stored schema with defaults such as format, version, branding, revocability, and status.

## Request body

- object
  - `name` string, required — Human-readable schema name.
  - `vct` string, required — VCT (Verifiable Credential Type) value to embed in issued credentials.
  - `attributes` object[], required — Claim attributes to include in credentials issued from this schema.
    - `name` string, required — Claim name to include in the credential.
    - `sd` boolean, required — Whether the claim supports selective disclosure.

## Response `201`

The credential schema was created.

- object
  - `uuid` string, uuid — Unique identifier of the credential schema.
  - `name` string — Human-readable schema name.
  - `vct` string — VCT (Verifiable Credential Type) value embedded in credentials issued from this schema.
  - `version` string — Schema version string.
  - `format` string — Credential format. The captured value is `sd_jwt_vc`, the SD-JWT VC (Selective-Disclosure JWT Verifiable Credential) format.
  - `attributes` object[] — Claim attributes stored on the schema.
    - `name` string — Claim name as it appears in the credential.
    - `sd` boolean — Whether the claim supports selective disclosure.
  - `branding` object — Wallet branding object returned with the schema. The captured example is an empty object.
  - `revocable` boolean — Whether issued credentials from this schema can be revoked.
  - `status` string — Lifecycle status of this schema version.
  - `supersedes` string, uuid, nullable — Schema UUID that this version supersedes. Null means this is the first version.
  - `created_at` string, date-time — Timestamp when the schema was created.

---

[API](https://skmtc.net/didit-protocol/apis/didit-credentials-api.md) · [All operations](https://skmtc.net/didit-protocol/apis/didit-credentials-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/didit-protocol/didit-credentials-api/versions/e4eddba66557/schema)