Skip to main content
POST
Create Credential Group

Description

This endpoint allows you to create a new credential group in Hyperstack. A credential group acts as a template container that organizes credentials by program or course.

Headers

string
required
Bearer YOUR_API_TOKEN — obtainable from Hyperstack Dashboard → Settings → API Access

Body Parameters

string
required
Title of the credential group.
string
required
Description of the credential group.
string
required
The template key for the certificate. At least one of certificate_template or badge_template is required.
string
required
The template key for the badge. At least one of certificate_template or badge_template is required.
string
required
External URL associated with the credential group.
array[string]
required
Tags related to the credential group.
string
required
A human-readable code for the group (e.g. CERT-2024). Alphanumeric, hyphens, and spaces only. Auto-generated if not provided.
boolean
required
Indicates whether credentials in this group expire. Defaults to false.
number
required
Validity period (in years) if does_expire is true.
boolean
required
Enables decentralized blockchain anchoring for credentials. Defaults to false.

Success Response Fields

boolean
Indicates whether the group creation was successful. Always true for a 200 response.
string
The unique key (ID) assigned to the newly created credential group.

Responses

Last modified on February 22, 2026