Create

post

https://api.certify.one/api/v2/issuer-api/issued-credentials

Issue a credential (REST style). Provide the recipient with name +
email, and the credential with credential_uuid or
credential_identifier.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

length ≥ 2

string

required

credential_uuid

string

required when credential_identifier is not present

credential_identifier

string

required when credential_uuid is not present

is_organization

boolean

Defaults to false

optional
default is false
accepted input are true, false, 1, 0, "1", "0"

expiration_date

date

optional
default is null
only yyyy-mm-dd format is allowed

completion_date

date

optional
default is null
only yyyy-mm-dd format is allowed
must be today or earlier (a future date is rejected)

notify_recipient

boolean

Defaults to true

optional
default is true
accepted input are true, false, 1, 0, "1", "0"

allow_duplication

boolean

Defaults to false

optional
default is false
when true, a new credential is issued even if the recipient already
has this credential (a duplicate). Duplication wins when both
allow_duplication and update_if_exists are set
accepted input are true, false, 1, 0, "1", "0"

update_if_exists

boolean

Defaults to false

optional
default is false
when true, if the recipient already has this credential it is updated
instead of being left unchanged. The response updated field reflects
whether this request actually mutated the credential
accepted input are true, false, 1, 0, "1", "0"

custom_fields

object

optional
custom field values to attach to the recipient and/or the issued
credential. Each key must match a custom field configured for your
account; unknown keys are rejected

certificate_pdf_url

uri

length ≤ 2048

optional
external https url to a certificate PDF. When set, it is used as the
certificate for this issuance instead of the badge's design template
(the external PDF takes precedence)
must be https and reachable; the file is downloaded and stored intact,
and a preview image + thumbnail are derived from its first page

Response

200OK