Create Certificate | Certifly Seven

curl -X POST http://localhost:8000/api/v1/certificates \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "data": {
    "id": "45",
    "data": {
      "code": "8bf20b39-f197-4d46-b5e6-870b10e5eea7",
      "data": {
        "Student Name": "Jane Doe"
      },
      "routes": {
        "check": "https://tenant.example.com/certificates/check/8bf20b39-f197-4d46-b5e6-870b10e5eea7",
        "download_pdf": "https://tenant.example.com/certificates/45/download/pdf/no",
        "download_png": "https://tenant.example.com/certificates/45/download/png/no"
      },
      "created_at": "2026-05-18T10:16:00+00:00",
      "updated_at": "2026-05-18T10:16:00+00:00",
      "is_rendered": false,
      "template_id": "1"
    },
    "type": "certificate"
  },
  "meta": [
    {
      "email_delivery": {
        "ok": true,
        "status": "sent",
        "message": "Certificate email queued successfully.",
        "requested": true,
        "delivery_id": "mail_01j9example"
      }
    }
  ]
}

Creates certificate for a template.

Validation (strict):

template_id: required, must exist in tenant DB
data: required object map
send_email: optional boolean
Keys in data must match template labels/extra fields
Required labels are enforced
Unknown keys rejected
String data sanitized

Behavior:

If send_email=true, response includes meta.email_delivery with delivery status details.

Scope: certificates.write

Creates certificate for a template. Validation (strict): - `template_id`: required, must exist in tenant DB - `data`: required object map - `send_email`: optional boolean - Keys in `data` must match template labels/extra fields - Required labels are enforced - Unknown keys rejected - String data sanitized Behavior: - If `send_email=true`, response includes `meta.email_delivery` with delivery status details. Scope: `certificates.write`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a string.

Response

Created

dataobject

metalist of any

Errors

422

Unprocessable Entity Error