Skip to main content
POST
/
v1
/
credentials
/
new
Issue Credential
curl --request POST \
  --url https://api.thehyperstack.com/v1/credentials/new \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipient": {},
  "recipient.name": "<string>",
  "recipient.email": "<string>",
  "group_key": "<string>",
  "custom_attributes": {}
}
'
{
  "success": true,
  "status": "published",
  "document_id": "j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
  "document_url": "https://hyperstack.id/credential/j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
  "recipient": { "name": "John Doe", "email": "john@example.com" },
  "group": { "title": "Cloud Certification", "key": "GcI6H5b66a3v", "code": "CC-2024" },
  "issued_on": "2024-03-15T10:30:00Z",
  "valid_until": null,
  "metadata": { "custom_location": "Mars" },
  "privacy": "public"
}

​
Description

This endpoint allows you to issue a new credential to a recipient within a specific credential group. The credential is immediately published.
Legacy endpoint: POST /v1/credential/issue is also supported for backward compatibility.

​
Headers

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

​
Body Parameters

​
recipient
object
required
Information about the recipient of the credential.
​
recipient.name
string
required
Full name of the recipient.
​
recipient.email
string
required
Email address of the recipient.
​
group_key
string
required
The unique key of the credential group in which this credential will be issued.
​
custom_attributes
object
required
Key-value pairs of custom attributes to embed in the credential. Keys must match the custom fields (prefixed with custom_) configured for your account.

​
Success Response Fields

​
success
boolean
Indicates whether the credential was successfully issued.
​
document_id
string
The unique ID of the newly created credential.
​
document_url
string
URL to view the newly created credential.
​
status
string
Publication status of the credential. Will be "published" for this endpoint.
​
recipient
object
Object containing name and email of the recipient.
​
group
object
Object containing title, key, and code of the credential group.
​
issued_on
string
ISO 8601 timestamp of when the credential was issued.
​
valid_until
string
ISO 8601 expiry timestamp. null if the credential does not expire.
​
metadata
object
Custom attribute values stored with the credential.
​
privacy
string
Visibility of the credential — "public" or "private".

​
Responses

{
  "success": true,
  "status": "published",
  "document_id": "j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
  "document_url": "https://hyperstack.id/credential/j4nDvaxF6ehodPXI84p4X1yhQe7lrYgx",
  "recipient": { "name": "John Doe", "email": "john@example.com" },
  "group": { "title": "Cloud Certification", "key": "GcI6H5b66a3v", "code": "CC-2024" },
  "issued_on": "2024-03-15T10:30:00Z",
  "valid_until": null,
  "metadata": { "custom_location": "Mars" },
  "privacy": "public"
}

curl -X POST "https://api.thehyperstack.com/v1/credentials/new" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {
      "name": "John Doe",
      "email": "john@example.com"
    },
    "group_key": "GcI6H5b66a3v",
    "custom_attributes": {
      "custom_date": "2035",
      "custom_location": "Mars"
    }
  }'
Last modified on February 22, 2026