IMAGE
certificate
1200×840px
Achievement Certificate Card
Shareable certificate-of-completion image. Landscape format with decorative border, recipient name, course title, organisation, and completion date. Suitable for sharing on social media after finishing a course or earning a badge.
Use Cases
- Online course completion certificates
- Workshop attendance certificates
- Employee training completion
- Social-shareable badge images
Tags
certificate
achievement
course
e-learning
award
diploma
completion
1200x840
Template Variables
| Variable | Type | Default | Description |
|---|---|---|---|
| recipient_name | string | Jane Smith | Recipient's full name (displayed prominently) |
| course_name | string | Advanced Python Programming | Course or achievement title |
| organisation | string | Acme Academy | Issuing organisation name |
| completion_date | string | 7th May 2026 | Completion or award date |
| instructor_name | string | Instructor or signatory name (leave blank to omit) | |
| logo_url | url | Organisation logo URL (leave blank to omit) | |
| accent_color | color | #7c3aed | Primary accent colour for borders and headings |
| border_color | color | #a78bfa | Decorative border colour |
| bg_color | color | #fdfcff | Certificate background colour |
| certificate_id | string | Optional certificate ID or serial number |
API Example
POST to
https://image.toolkitapi.io/v1/image/from-template
with your template URL and variable values.
curl -X POST "https://image.toolkitapi.io/v1/image/from-template" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"template_url": "https://toolkitapi.io/static/templates/image/img-certificate.html", "variables": {"recipient_name": "Jane Smith", "course_name": "Advanced Python Programming", "organisation": "Acme Academy", "completion_date": "7th May 2026", "instructor_name": "", "logo_url": "", "accent_color": "#7c3aed", "border_color": "#a78bfa", "bg_color": "#fdfcff", "certificate_id": ""}, "width": 1200, "height": 840, "format": "png"}'
import httpx, base64
resp = httpx.post(
"https://image.toolkitapi.io/v1/image/from-template",
headers={"X-API-Key": "YOUR_API_KEY"},
json={
"template_url": "https://toolkitapi.io/static/templates/image/img-certificate.html",
"variables": {
"recipient_name": "Jane Smith",
"course_name": "Advanced Python Programming",
"organisation": "Acme Academy",
"completion_date": "7th May 2026",
"instructor_name": "",
"logo_url": "",
"accent_color": "#7c3aed",
"border_color": "#a78bfa",
"bg_color": "#fdfcff",
"certificate_id": ""
},
"width": 1200,
"height": 840,
"format": "png"
},
)
image_bytes = base64.b64decode(resp.json()["image"])
with open("result.png", "wb") as f:
f.write(image_bytes)
const response = await fetch("https://image.toolkitapi.io/v1/image/from-template", {
method: "POST",
headers: {
"X-API-Key": "YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
"template_url": "https://toolkitapi.io/static/templates/image/img-certificate.html",
"variables": {
"recipient_name": "Jane Smith",
"course_name": "Advanced Python Programming",
"organisation": "Acme Academy",
"completion_date": "7th May 2026",
"instructor_name": "",
"logo_url": "",
"accent_color": "#7c3aed",
"border_color": "#a78bfa",
"bg_color": "#fdfcff",
"certificate_id": ""
},
"width": 1200,
"height": 840,
"format": "png"
}),
});
const data = await response.json();
// data.image is a base64-encoded PNG
$body = @{
template_url = "https://toolkitapi.io/static/templates/image/img-certificate.html"
variables = {
"recipient_name": "Jane Smith",
"course_name": "Advanced Python Programming",
"organisation": "Acme Academy",
"completion_date": "7th May 2026",
"instructor_name": "",
"logo_url": "",
"accent_color": "#7c3aed",
"border_color": "#a78bfa",
"bg_color": "#fdfcff",
"certificate_id": ""
}
width = 1200
height = 840
format = "png"
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Method POST `
-Uri "https://image.toolkitapi.io/v1/image/from-template" `
-Headers @{"X-API-Key" = "YOUR_API_KEY"} `
-ContentType "application/json" `
-Body $body