{ "id": "iSAAea98kDZBv13F", "meta": { "templateCredsSetupCompleted": true }, "name": "AI Course Completion Certificate Generation & Delivery System", "tags": [], "nodes": [ { "id": "02368070-2582-4a54-929b-7658001e8ef4", "name": "Section: Error Handler", "type": "n8n-nodes-base.stickyNote", "position": [ -1456, 1616 ], "parameters": { "color": 7, "width": 620, "height": 400, "content": "## \u26a0\ufe0f Error Handler\nCatches any failure in the workflow and posts a Slack alert. Wire the error output of critical nodes here to prevent silent failures going unnoticed." }, "typeVersion": 1 }, { "id": "408c15f4-4c3e-463e-8fb5-60670e5bcb27", "name": "On Workflow Error", "type": "n8n-nodes-base.errorTrigger", "position": [ -1344, 1792 ], "parameters": {}, "typeVersion": 1 }, { "id": "ca16dcd4-2df0-4e6b-af95-bbcdd25a5bfc", "name": "Slack \u2014 Send Workflow Error Alert", "type": "n8n-nodes-base.slack", "position": [ -1088, 1792 ], "parameters": { "text": "=error in the workflow please check ", "select": "channel", "channelId": { "__rl": true, "mode": "list", "value": "C0AN1UGL0RM", "cachedResultName": "all-n8n-automations" }, "otherOptions": {}, "authentication": "oAuth2" }, "credentials": { "slackOAuth2Api": { "name": "" } }, "typeVersion": 2.3 }, { "id": "2cfda26b-e9a2-41bb-a480-031c23a8e051", "name": "Sticky Note \u2013 Overview", "type": "n8n-nodes-base.stickyNote", "position": [ -2816, 240 ], "parameters": { "color": 2, "width": 940, "height": 728, "content": "## \ud83c\udf93 AI Certificate Generator \u2014 LMS Course Completion Automation\n\n### How it works\nWhen a student completes a course in your LMS, a webhook fires with their score and course ID. The workflow checks their score against a pass threshold stored in Google Sheets, and if they pass, calls Groq's free Llama API to write a personalised certificate body. The certificate is rendered as styled HTML, converted to a PDF via PDFShift, logged to an issued certificates registry, and emailed to the student \u2014 all within seconds. Failed attempts exit cleanly without generating a certificate.\n\n### Setup steps\n1. **Webhook** \u2014 Point your LMS webhook to the `Receive Course Completion Event` node URL. Use the pinned test payload to verify the connection.\n2. **Google Sheets** \u2014 Connect OAuth2. Replace `YOUR_SPREADSHEET_ID` in both sheet nodes. Create two tabs: `CourseThresholds` (course_id, course_title, pass_score, certificate_template) and `IssuedCertificates` (cert_id, student_name, student_email, course_name, score, completion_date, issued_at, status).\n3. **Groq AI** \u2014 Sign up free at console.groq.com, create an API key, and add it as an n8n credential. Replace the Authorization header value.\n4. **PDFShift** \u2014 Create an account at pdfshift.io, copy your API key, and replace the `X-API-Key` header. Use `\"sandbox\": true` in the body while testing.\n5. **Gmail** \u2014 Connect OAuth2. Update the `sendTo` field to use `$json.studentEmail` dynamically.\n6. **Slack** \u2014 Connect your workspace. Update the channel ID in the error alert node.\n7. Test end-to-end using the pinned webhook payload." }, "typeVersion": 1 }, { "id": "0c443bf9-7020-45c0-a752-9293ea795ceb", "name": "Sticky Note \u2013 Trigger & Pass Validation", "type": "n8n-nodes-base.stickyNote", "position": [ -1712, 944 ], "parameters": { "color": 7, "width": 796, "height": 560, "content": "## \ud83d\udce5 Trigger & Pass Validation\nReceives the LMS webhook payload, looks up the course pass threshold from Google Sheets, and gates the flow. Students who meet the score proceed to certificate generation; those who don't exit here." }, "typeVersion": 1 }, { "id": "91a69c30-84dd-4b69-968b-e94357a10323", "name": "Sticky Note \u2013 AI Text & Certificate Build", "type": "n8n-nodes-base.stickyNote", "position": [ -880, 944 ], "parameters": { "color": 7, "width": 636, "height": 560, "content": "## \ud83e\udd16 AI Text Generation & Certificate Build\nGroq's free Llama model writes a warm, personalised 2\u20133 sentence certificate body based on the student's name, score, course, and completion date. The result is combined with student data into a fully styled HTML certificate ready for PDF conversion." }, "typeVersion": 1 }, { "id": "c41765c2-d4c7-41c7-9d72-e2bfb7f70c42", "name": "Sticky Note \u2013 PDF, Logging & Delivery", "type": "n8n-nodes-base.stickyNote", "position": [ -192, 944 ], "parameters": { "color": 7, "width": 1000, "height": 560, "content": "## \ud83d\udcc4 PDF Conversion, Logging & Delivery\nPDFShift converts the HTML certificate to a print-quality A4 PDF in a single API call. The certificate record is logged to the IssuedCertificates sheet for verification, then emailed to the student with the PDF attached." }, "typeVersion": 1 }, { "id": "a3b8f691-9e65-45b7-8ec5-5c8b2837127b", "name": "Sticky Note \u2013 Credentials & Security", "type": "n8n-nodes-base.stickyNote", "position": [ 512, 1584 ], "parameters": { "color": 3, "width": 380, "height": 276, "content": "## \ud83d\udd10 Credentials & Security\nUse OAuth2 for Gmail and Google Sheets. Store Groq and PDFShift API keys via n8n credentials manager \u2014 never paste them directly into node headers. Replace all sample emails, IDs, and channel values before publishing." }, "typeVersion": 1 }, { "id": "b36ce8cf-0358-4350-bbf9-84931c3fd88a", "name": "Groq AI \u2013 Generate Personalised Certificate Text", "type": "n8n-nodes-base.httpRequest", "position": [ -704, 1200 ], "parameters": { "url": "https://api.groq.com/openai/v1/chat/completions", "method": "POST", "options": {}, "jsonBody": "={\n \"model\": \"llama-3.1-8b-instant\",\n \"max_tokens\": 300,\n \"messages\": [\n {\n \"role\": \"system\",\n \"content\": \"You are a professional certificate copy writer. Generate warm, personalised certificate body text. Return ONLY the certificate body paragraph \u2014 no headings, no extra text, no quotes.\"\n },\n {\n \"role\": \"user\",\n \"content\": \"Write a 2-3 sentence professional yet warm certificate body for:\\n\\nStudent Name: {{ $('Receive Course Completion Event').item.json.body.student_name }}\\nCourse: {{ $('Lookup Course Pass Threshold').item.json.course_title }}\\nScore Achieved: {{ $('Receive Course Completion Event').item.json.body.score }}%\\nCompletion Date: {{ $('Receive Course Completion Event').item.json.body.completion_date }}\\nCertificate Type: {{ $('Lookup Course Pass Threshold').item.json.certificate_template }}\\n\\nMention the score and date naturally. No headings, no quotes.\"\n }\n ]\n}", "sendBody": true, "sendHeaders": true, "specifyBody": "json", "headerParameters": { "parameters": [ { "name": "Authorization", "value": "Bearer YOUR_TOKEN_HERE" }, { "name": "Content-Type", "value": "application/json" } ] } }, "typeVersion": 4.2 }, { "id": "30d3018a-e02c-4f84-82a9-8727b972365b", "name": "Receive Course Completion Event", "type": "n8n-nodes-base.webhook", "position": [ -1616, 1216 ], "parameters": { "path": "course-completion", "options": {}, "httpMethod": "POST" }, "typeVersion": 2 }, { "id": "340edcae-934d-4962-9a95-7b0a24c50ecf", "name": "Lookup Course Pass Threshold", "type": "n8n-nodes-base.googleSheets", "position": [ -1376, 1216 ], "parameters": { "options": {}, "sheetName": { "__rl": true, "mode": "list", "value": 1706642941, "cachedResultUrl": "https://docs.google.com/spreadsheets/d/YOUR_SPREADSHEET_ID/edit#gid=1706642941", "cachedResultName": "CourseThresholds_sheet" }, "documentId": { "__rl": true, "mode": "list", "value": "YOUR_SPREADSHEET_ID", "cachedResultUrl": "https://docs.google.com/spreadsheets/d/YOUR_SPREADSHEET_ID/edit?usp=drivesdk", "cachedResultName": "certificate_automation_data" } }, "typeVersion": 4.4 }, { "id": "ba69f61c-84ab-4b03-8b01-f95e5bfc5674", "name": "Check \u2013 Score Meets Pass Threshold", "type": "n8n-nodes-base.if", "position": [ -1136, 1216 ], "parameters": { "options": {}, "conditions": { "options": { "version": 1, "leftValue": "", "caseSensitive": false, "typeValidation": "strict" }, "combinator": "and", "conditions": [ { "id": "score-check", "operator": { "type": "number", "operation": "gte" }, "leftValue": "={{ $('Receive Course Completion Event').item.json.body.score }}", "rightValue": "={{ $json.pass_score }}" } ] } }, "typeVersion": 2.2 }, { "id": "a1d9a258-c3c1-4b42-8147-4113d2e69a96", "name": "Build Styled HTML Certificate", "type": "n8n-nodes-base.code", "position": [ -464, 1200 ], "parameters": { "jsCode": "// Extract AI-generated certificate text (Groq uses OpenAI-compatible format)\nconst aiResponse = $input.item.json;\nconst personalizedText = aiResponse.choices[0].message.content.trim();\n\n// Pull original data\nconst webhookData = $('Receive Course Completion Event').item.json.body;\nconst sheetData = $('Lookup Course Pass Threshold').item.json;\n\n// Format date nicely\nconst rawDate = webhookData.completion_date;\nconst formatted = new Date(rawDate).toLocaleDateString('en-IN', {\n day: 'numeric', month: 'long', year: 'numeric'\n});\n\n// Generate a unique certificate ID\nconst certId = `CERT-${webhookData.course_id}-${webhookData.student_id}-${Date.now()}`;\n\n// Build the HTML certificate\nconst html = `\n\n\n\n\n\n\n
\n
YourOrg Academy
\n
Certificate of Completion
\n
of Achievement
\n
This certificate is proudly presented to
\n
${webhookData.student_name}
\n
${personalizedText}
\n
\n
\n
Course
\n
${sheetData.course_title}
\n
\n
\n
Score
\n
${webhookData.score}%
\n
\n
\n
Date
\n
${formatted}
\n
\n
\n
\n
ID: ${certId}
\n
Verified \u2713
\n
${webhookData.student_email}
\n
\n
\n\n`;\n\nreturn {\n html,\n certId,\n studentName: webhookData.student_name,\n studentEmail: webhookData.student_email,\n courseName: sheetData.course_title,\n score: webhookData.score,\n completionDate: formatted,\n personalizedText\n};" }, "typeVersion": 2 }, { "id": "5a4dd282-feee-4f49-a3a1-d5a39da564e8", "name": "Log Issued Certificate to Registry", "type": "n8n-nodes-base.googleSheets", "position": [ 304, 1200 ], "parameters": { "columns": { "value": { "score": "={{ $('Build Styled HTML Certificate').item.json.score }}", "status": "issued", "cert_id": "={{ $('Build Styled HTML Certificate').item.json.certId }}", "issued_at": "={{ new Date().toISOString() }}", "course_name": "={{ $('Build Styled HTML Certificate').item.json.courseName }}", "student_name": "={{ $('Build Styled HTML Certificate').item.json.studentName }}", "student_email": "={{ $('Build Styled HTML Certificate').item.json.studentEmail }}", "completion_date": "={{ $('Build Styled HTML Certificate').item.json.completionDate }}" }, "schema": [ { "id": "cert_id", "type": "string", "display": true, "removed": false, "required": false, "displayName": "cert_id", "defaultMatch": false, "canBeUsedToMatch": true }, { "id": "student_name", "type": "string", "display": true, "required": false, "displayName": "student_name", "defaultMatch": false, "canBeUsedToMatch": true }, { "id": "student_email", "type": "string", "display": true, "required": false, "displayName": "student_email", "defaultMatch": false, "canBeUsedToMatch": true }, { "id": "course_name", "type": "string", "display": true, "required": false, "displayName": "course_name", "defaultMatch": false, "canBeUsedToMatch": true }, { "id": "score", "type": "string", "display": true, "required": false, "displayName": "score", "defaultMatch": false, "canBeUsedToMatch": true }, { "id": "completion_date", "type": "string", "display": true, "required": false, "displayName": "completion_date", "defaultMatch": false, "canBeUsedToMatch": true }, { "id": "issued_at", "type": "string", "display": true, "required": false, "displayName": "issued_at", "defaultMatch": false, "canBeUsedToMatch": true }, { "id": "status", "type": "string", "display": true, "required": false, "displayName": "status", "defaultMatch": false, "canBeUsedToMatch": true } ], "mappingMode": "defineBelow", "matchingColumns": [ "cert_id" ], "attemptToConvertTypes": false, "convertFieldsToString": false }, "options": {}, "operation": "appendOrUpdate", "sheetName": { "__rl": true, "mode": "list", "value": 709531373, "cachedResultUrl": "https://docs.google.com/spreadsheets/d/YOUR_SPREADSHEET_ID/edit#gid=709531373", "cachedResultName": "IssuedCertificates_sheet" }, "documentId": { "__rl": true, "mode": "list", "value": "YOUR_SPREADSHEET_ID", "cachedResultUrl": "https://docs.google.com/spreadsheets/d/YOUR_SPREADSHEET_ID/edit?usp=drivesdk", "cachedResultName": "certificate_automation_data" } }, "typeVersion": 4.4 }, { "id": "cb2d1664-e028-4ecd-9c0e-c7edcff4f862", "name": "Gmail \u2013 Email Certificate PDF to Student", "type": "n8n-nodes-base.gmail", "position": [ 576, 1200 ], "parameters": { "sendTo": "={{ $('Build Styled HTML Certificate').item.json.studentEmail }}", "message": "=
\n
\n

Congratulations, {{ $('Build Styled HTML Certificate').item.json.studentName }}! \ud83c\udf89

\n

\n You've successfully completed {{ $('Build Styled HTML Certificate').item.json.courseName }} with a score of {{ $('Build Styled HTML Certificate').item.json.score }}%.\n

\n

\n {{ $('Build Styled HTML Certificate').item.json.personalizedText }}\n

\n
\n

Certificate ID

\n

{{ $('Build Styled HTML Certificate').item.json.certId }}

\n
\n

Your certificate is attached as a PDF. Keep it safe \u2014 you can share the Certificate ID above for instant verification.

\n
\n
", "options": { "attachmentsUi": { "attachmentsBinary": [ { "property": "certificatePdf" } ] } }, "subject": "=\ud83c\udf93 Your Certificate for {{ $('Build Styled HTML Certificate').item.json.courseName }} is Ready!" }, "typeVersion": 2.1 }, { "id": "c58e3863-9688-4da5-98d3-bb126b39e4c8", "name": "PDFShift \u2013 Convert HTML Certificate to PDF", "type": "n8n-nodes-base.httpRequest", "position": [ -48, 1200 ], "parameters": { "url": "https://api.pdfshift.io/v3/convert/pdf", "method": "POST", "options": { "response": { "response": { "responseFormat": "file", "outputPropertyName": "certificatePdf" } } }, "jsonBody": "={\n \"source\": {{ JSON.stringify($json.html) }},\n \"landscape\": true,\n \"format\": \"A4\",\n \"margin\": { \"top\": 0, \"right\": 0, \"bottom\": 0, \"left\": 0 }\n}", "sendBody": true, "sendHeaders": true, "specifyBody": "json", "headerParameters": { "parameters": [ { "name": "X-API-Key", "value": "YOUR_PDFSHIFT_API_KEY_HERE" }, { "name": "Content-Type", "value": "application/json" } ] } }, "typeVersion": 4.2 } ], "active": false, "settings": { "binaryMode": "separate", "availableInMCP": false, "executionOrder": "v1" }, "versionId": "23f9cd21-8c27-4b37-b883-7356166ea1db", "nodeGroups": [], "connections": { "On Workflow Error": { "main": [ [ { "node": "Slack \u2014 Send Workflow Error Alert", "type": "main", "index": 0 } ] ] }, "Lookup Course Pass Threshold": { "main": [ [ { "node": "Check \u2013 Score Meets Pass Threshold", "type": "main", "index": 0 } ] ] }, "Build Styled HTML Certificate": { "main": [ [ { "node": "PDFShift \u2013 Convert HTML Certificate to PDF", "type": "main", "index": 0 } ] ] }, "Receive Course Completion Event": { "main": [ [ { "node": "Lookup Course Pass Threshold", "type": "main", "index": 0 } ] ] }, "Log Issued Certificate to Registry": { "main": [ [ { "node": "Gmail \u2013 Email Certificate PDF to Student", "type": "main", "index": 0 } ] ] }, "Check \u2013 Score Meets Pass Threshold": { "main": [ [ { "node": "Groq AI \u2013 Generate Personalised Certificate Text", "type": "main", "index": 0 } ] ] }, "PDFShift \u2013 Convert HTML Certificate to PDF": { "main": [ [ { "node": "Log Issued Certificate to Registry", "type": "main", "index": 0 } ] ] }, "Groq AI \u2013 Generate Personalised Certificate Text": { "main": [ [ { "node": "Build Styled HTML Certificate", "type": "main", "index": 0 } ] ] } } }