Create a credential
Don't see what you need?
This API is still growing. If an endpoint, parameter, or filter you need isn't here yet — or you just have a question — tell us. We read every message and regularly add new capabilities based on real use cases from customers like you.
Use this endpoint to create a new credential.
The credential will be created with status draft.
As the next step, use the Issue Credential endpoint to issue a draft credential, making it active and accessible in the digital wallet.
If you are looking for an all-in-one solution that simultaneously creates, issues, and sends a credential, check the Create, Issue and Send a Credential endpoint.
Authorization
BearerAuth Provide your access token in the Authorization header with Bearer auth-scheme. You can view and manage your access tokens in the Certifier Dashboard.
In: header
Header Parameters
API version header. Required for all requests.
"2022-10-26"Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/credentials" \ -H "Certifier-Version: 2022-10-26" \ -H "Content-Type: application/json" \ -d '{ "groupId": "string", "recipient": { "name": "string" } }'{ "id": "string", "publicId": "f72dfe8e-6cfd-43c2-b1cb-95adbf313789", "groupId": "string", "status": "draft", "recipient": { "id": "string", "name": "string", "email": "user@example.com" }, "issueDate": "string", "expiryDate": "string", "attributes": { "property1": null, "property2": null }, "customAttributes": { "property1": null, "property2": null }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}Get credential design templates GET
Use this endpoint to list the ordered design templates used by a credential and their available previews. Preview URLs are immutable and versioned by a digest (hash) derived from the design template's last update timestamp and the resolved values of all rendered credential attributes.
Create, issue, and send a credential POST
Use this endpoint to issue a credential. It is an all-in-one solution that simultaneously creates, issues, and sends a credential. This endpoint covers most of the basic scenarios.