Company logoTrust Center Documentation
API v1 ReferenceCertifications

Create certification metadata

Create certification metadata without file uploads. Files and badges must be uploaded separately using dedicated endpoints.

Create certification metadata without file uploads. Files and badges must be uploaded separately using dedicated endpoints.

POST
/api/v1/certifications

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://app.orbiqhq.com/api/v1/certifications" \  -H "Content-Type: application/json" \  -d '{    "title": "ISO 27001 Certificate",    "slug": "iso-27001",    "description": "Information Security Management System certification",    "issue_date": "2025-01-15",    "validity_months": 36,    "featured": true  }'
{
  "success": true,
  "data": {
    "documentId": "4704590c-004e-410d-adf7-acb7ca0a7052",
    "uploadUrls": {
      "document": "/api/v1/certifications/cert-123/document",
      "badge": "/api/v1/certifications/cert-123/badge"
    }
  }
}
{
  "error": "Invalid input: title: title_required"
}
Empty
{
  "error": "Invalid input: title: title_required"
}
Empty

How is this guide?