Recipients

Issue a single certificate

Creates one recipient (= one certificate) in the batch. A new certificateId and shareToken are minted automatically unless you supply your own. Set send: true to enqueue the certificate email immediately — the batch must have an emailTemplateId and the server must have Resend configured.

Consumes one unit of plan quota.

post/batches/{batchId}/recipients

Request

  • Base URL: https://services.certseal.com/api/v1
  • URL: https://services.certseal.com/api/v1/batches/{batchId}/recipients
  • Auth: HTTP bearer

Path parameters

batchIdstring required

Request body

namestring nullable
emailstring email nullable
certificateIdstring nullable

Override the auto-generated certificate id. Must be unique across the whole system; duplicates return 409.

issueDatestring date nullable

ISO date (or full ISO timestamp).

expiryDatestring date nullable
dataobject

Free-form key/value bag interpolated into the certificate template wherever {{key}} appears.

sendboolean

When true, also queue the certificate email immediately. Requires the batch to have emailTemplateId set and the server to have Resend configured.

Response

The created recipient.

Example response

{
  "recipient": {
    "certificateId": "CERT-2026-003843-000001"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.