API Reference

Create and send a single request in one call

post
https://ecm.cert.ceretax.net/certificate-requests

One-shot create-and-send for a single customer. Unlike
POST /certificates/requests (which creates a draft), this creates the
request, sends the email, and returns the sent request. Returns 201.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≥ 3
integer
required
≥ 1
string
enum
required

Only email is supported.

Allowed:
string

Required unless contactId is supplied. Validated whenever present.

integer

Must be a recognized template (1-3). Defaults to the seeded default when omitted.

integer

Customer contact used for delivery. When 0, recipientEmail is used.

exemptRegion
object

Optional region/reason scope. When enabled is true, stateId and exemptionReasonId are required.

certificates
array of objects

One row per certificate for this customer, unique on
(stateId, exemptionReasonId). When empty, exemptRegion is the
single-certificate fallback.

certificates
attachments
object
string
integer
required
≥ 1
Responses

Updated 3 days ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 days ago

Did this page help you?