Issue a credential to ONE recipient
accredible_issue_credentialDestructive
WRITE: creates ONE credential (badge or certificate) for ONE recipient in an existing group. By default it is created UNPUBLISHED (a draft: no e-mail is sent and no credit is used); publish it later in the Accredible Dashboard. With publish=true the credential is published immediately: Accredible then SENDS AN E-MAIL to the recipient (as configured in the group's e-mail settings) and uses one credential credit of the account; an account without credits keeps it unpublished. A sandbox-mode setting in the Dashboard overrides publish. Not idempotent: calling twice creates two credentials (set credential_id to your own unique id to be able to find it again). No evidence, references, bulk issuing, edits or deletes. POST /v1/credentials.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Credential/course name; required only when the group has no course name. | |
| private | No | Make the credential private: visible only to the recipient after signing in to credential.net. | |
| publish | No | Default false: create an unpublished draft (no e-mail). true: publish now, which e-mails the recipient and uses one credit. | |
| complete | No | Whether the achievement is complete (default true); false marks it in progress. | |
| group_id | Yes | The group the credential belongs to (accredible_search_groups); it supplies the design and course texts. | |
| issued_on | No | Issue date YYYY-MM-DD (default today). | |
| meta_data | No | Key/value strings you attached to the object's meta_data when you created it; matches objects carrying these pairs. | |
| expired_on | No | Expiry date YYYY-MM-DD (default none). | |
| description | No | Credential/course description; required only when the group has no course description. | |
| recipient_id | No | Your own id for the recipient (maps recipients to credentials across e-mail changes). | |
| credential_id | No | Your own unique id for this credential (license_id); Accredible assigns one if omitted. | |
| recipient_name | Yes | The recipient's full name as printed on the credential. | |
| recipient_email | Yes | The recipient's e-mail address (exactly one recipient). | |
| custom_attributes | No | Custom attribute values merged into the design, e.g. {"Location": "London"} (keys must exist: accredible_search_attribute_keys). |