issue_badge
Create and send digital certificates to recipients with email notifications and verification links for credential verification.
Instructions
Issue a badge to a recipient. This creates a digital certificate and sends notification email with verification URL.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
badge_id | Yes | Encrypted badge ID from badge creation (get this from get_all_badges or create_badge) | |
No | Recipient's email address (optional, but recommended for notifications) | ||
idempotency_key | Yes | Unique key to prevent duplicate issuance (e.g., "issue_john_doe_2024_001") | |
metadata | No | Custom field values and additional metadata (e.g., completion_date, score, etc.) | |
name | Yes | Recipient's full name (will appear on the certificate) | |
phone | No | Recipient's phone number (optional) |
Input Schema (JSON Schema)
{
"properties": {
"badge_id": {
"description": "Encrypted badge ID from badge creation (get this from get_all_badges or create_badge)",
"type": "string"
},
"email": {
"description": "Recipient's email address (optional, but recommended for notifications)",
"format": "email",
"type": "string"
},
"idempotency_key": {
"description": "Unique key to prevent duplicate issuance (e.g., \"issue_john_doe_2024_001\")",
"type": "string"
},
"metadata": {
"additionalProperties": true,
"description": "Custom field values and additional metadata (e.g., completion_date, score, etc.)",
"type": "object"
},
"name": {
"description": "Recipient's full name (will appear on the certificate)",
"type": "string"
},
"phone": {
"description": "Recipient's phone number (optional)",
"type": "string"
}
},
"required": [
"badge_id",
"name",
"idempotency_key"
],
"type": "object"
}