![](\"https://your-domain.com/logo.png\"){kind=logo}
\n\n© 2025 Your Company Name
\nContact: support@yourcompany.com
\n```\n\n**Change Header Color:**\n```css\n.header { \n background: linear-gradient(135deg, #YOUR_COLOR_1, #YOUR_COLOR_2);\n}\n```\n\n### Certificate ID Format\n\nIn \"Generate HTML Certificate\" node:\n```javascript\n// Custom format: COURSE-YEAR-NUMBER\nconst certId = `${data.course.substring(0,3).toUpperCase()}-${new Date().getFullYear()}-${Math.floor(Math.random() * 10000)}`;\n```\n\n---\n\n## Data Flow\n\n```\nWebhook → Email Validation → Field Validation → Combine Data\n ↓\nGenerate HTML → Convert to PNG → Send Email\n ↓\nLog to Sheets → Success Response\n ↓\nError Handling (if failed)\n```\n\n---\n\n## Expected Output\n\n**PNG Certificate Includes:**\n- Branded header with logo/company name\n- Recipient name in large display font\n- Course name and duration\n- Formatted completion date\n- Instructor signature section\n- Unique certificate ID\n- Gold achievement badge\n- Professional borders and styling\n\n**Google Sheets Entry:**\n- Certificate ID\n- Recipient details\n- Course information\n- Completion date and time\n- Direct link to certificate image\n- Status: \"Sent\"\n\n**Email Notification:**\n- Professional HTML template\n- Personalized congratulations message\n- Direct download button\n- Certificate details table\n- LinkedIn sharing encouragement\n\n---\n\n## Performance\n\n- **Processing Time:** 5-10 seconds per certificate\n- **Daily Capacity:** 250+ certificates (limited by free tier quotas)\n- **Image Resolution:** 1200x850px (print-ready)\n- **File Size:** ~200-400 KB per PNG\n- **Email Delivery:** ~98% success rate\n\n---\n\n## Troubleshooting\n\n**Webhook not receiving data**\n- Verify webhook URL is correct\n- Check n8n workflow is activated\n- Ensure POST method is used\n- Validate JSON format\n\n**Email validation fails**\n- Use real email domains (not example.com)\n- Check VerifiEmail API quota\n- Verify API credentials are correct\n- Test with gmail.com addresses first\n\n**Certificate not generating**\n- Check required fields are present\n- Verify date format is YYYY-MM-DD\n- Review \"Generate HTML Certificate\" node logs\n- Ensure HTMLcsstoImg API key valid\n\n**Image conversion fails**\n- Verify HTMLcsstoImg credits available\n- Check HTML syntax is valid\n- Review API response in execution logs\n- Test HTML locally first\n\n**Email not delivered**\n- Confirm Gmail OAuth2 connected\n- Check recipient email is valid\n- Review spam/junk folders\n- Verify Gmail daily limit not exceeded\n\n**Google Sheets not updating**\n- Re-authenticate Google Sheets OAuth2\n- Verify spreadsheet permissions\n- Check column names match exactly\n- Ensure sheet exists and is accessible\n\n---\n\n## Best Practices\n\n1. **Test with small batches** before production rollout\n2. **Monitor API quotas** to avoid unexpected failures\n3. **Use real email addresses** during testing (avoid disposable)\n4. **Archive old certificates** periodically from Google Sheets\n5. **Set up Slack notifications** for error monitoring\n6. **Validate webhook payload** before sending\n7. **Document customizations** for team reference\n8. **Back up Google Sheets** regularly\n9. **Review email deliverability** weekly\n10. **Keep credentials secure** and rotate periodically\n\n---\n\n## Security Notes\n\n- All API credentials encrypted in n8n\n- Certificate URLs are publicly accessible via direct link\n- Email validation prevents delivery to fraudulent addresses\n- Webhook uses HTTPS for secure data transmission\n- Google Sheets access controlled via OAuth2 permissions\n- No sensitive data stored in workflow logs\n\n---\n\n## Future Enhancements\n\n- PDF output option for formal certifications\n- Multiple certificate templates (modern, classic, minimalist)\n- QR code verification system\n- Batch certificate generation\n- Multi-language support\n- Certificate revocation capability\n- Analytics dashboard\n- WhatsApp/SMS delivery option\n- Integration with Notion/Confluence knowledge bases\n\n---\n\n## Support Resources\n\n- [n8n Documentation](https://docs.n8n.io)\n- [n8n Community Forum](https://community.n8n.io)\n- [VerifiEmail Docs](https://verifi.email/docs)\n- [HTMLcsstoImage API](https://htmlcsstoimage.com/docs)\n- [Gmail API Reference](https://developers.google.com/gmail/api)\n- [Google Sheets API](https://developers.google.com/sheets/api)\n\n---\n\n## License\n\nThis workflow template is provided as-is for free use and modification under the MIT License. Attribution appreciated but not required.\n\n**Version:** 1.0.0 \n**Last Updated:** October 2025 \n**Compatibility:** n8n v1.0.0+", "workflow": { "id": "", "meta": { "instanceId": "" }, "name": "certificate generator", "tags": [ { "id": "CWzMtsCN0QfPR9PC", "name": "certificates", "createdAt": "2025-10-04T15:28:20.021Z", "updatedAt": "2025-10-04T15:28:20.021Z" }, { "id": "qFR253LK8bI8GX4z", "name": "automation", "createdAt": "2025-10-04T15:28:20.027Z", "updatedAt": "2025-10-04T15:28:20.027Z" } ], "nodes": [ { "id": "8aef6c7c-9dfd-483b-9b66-ee9a21ad0e3b", "name": "Credentials Setup Guide", "type": "n8n-nodes-base.stickyNote", "position": [ -3024, -96 ], "parameters": { "color": 7, "width": 452, "height": 856, "content": "## 🔧 CREDENTIALS SETUP REQUIRED\n\nBefore activating this workflow, configure these credentials:\n\n1. VerifiEmail API\n - Sign up at https://verifi.email\n - Get your API key from dashboard\n - In n8n: Add VerifiEmail credential\n - Paste API key\n\n2. HTMLcsstoImage API\n - Sign up at https://htmlcsstoimg.com\n - Get User ID and API Key\n - In n8n: Add HTMLcsstoImg credential\n - Enter User ID and API Key\n\n3. Gmail OAuth2 (for sending emails)\n - Go to Settings > Credentials\n - Add Gmail OAuth2\n - Follow Google OAuth setup\n - Grant necessary permissions\n - Test connection\n\n4. Google Sheets OAuth2 (for logging)\n - Add Google Sheets OAuth2 credential\n - Create spreadsheet: \"Certificates Log\"\n - Add these column headers:\n • Certificate ID\n • Recipient Name\n • Course\n • Email\n • Completion Date\n • Generated At\n • Certificate URL\n • Status\n • Instructor\n • Duration\n\n✅ All credentials configured in this workflow" }, "typeVersion": 1 }, { "id": "713712a6-27e5-482b-8994-eae001ab2785", "name": "Webhook Info", "type": "n8n-nodes-base.stickyNote", "position": [ -2512, 64 ], "parameters": { "color": 7, "width": 444, "height": 628, "content": "## 📥 WEBHOOK TRIGGER\n\nAccepts POST requests with certificate data\n\nRequired JSON format:\n```\n{\n \"name\": \"John Doe\",\n \"course\": \"Course Name\",\n \"date\": \"2025-10-04\",\n \"email\": \"user@example.com\"\n}\n```\nOptional fields:\n```\n{\n \"instructor\": \"Jane Smith\",\n \"duration\": \"40 hours\",\n \"certificateId\": \"CERT-2025-001\"\n}\n```\n🔗 Your Webhook URL:\n```https://n8n.exildraw.com/webhook-test/certificate-generator```\n\n📝 All data is accessed via:\n{{ $json.body.fieldName }}" }, "typeVersion": 1 }, { "id": "a8b8e036-c01d-4091-b817-43611a1e2643", "name": "Certificate Request Webhook", "type": "n8n-nodes-base.webhook", "position": [ -2192, 544 ], "webhookId": "certificate-generator", "parameters": { "path": "certificate-generator", "options": {}, "httpMethod": "POST", "responseMode": "lastNode" }, "typeVersion": 2 }, { "id": "3129040e-f390-4661-b17a-32b5c029cd8b", "name": "Email Validation Info", "type": "n8n-nodes-base.stickyNote", "position": [ -2016, 144 ], "parameters": { "color": 7, "width": 380, "height": 548, "content": "## 📧 EMAIL VALIDATION STEP\n\nUses VerifiEmail API to validate recipient email\n\nChecks performed:\n✓ RFC Compliance (proper email format)\n✓ Valid MX Records (domain accepts email)\n✓ Spoof Detection (checks for fake domains)\n✓ Disposable Email Detection (blocks temp emails)\n\nOutput includes:\n• valid: true/false\n• provider: email service provider\n• MX records: mail server details\n\n⚠️ Credential Required: VerifiEmail API key\n\nNext Step: IF node validates this + other fields" }, "typeVersion": 1 }, { "id": "5c1071ea-cc45-49b2-9498-083d3a09508b", "name": "Validation Logic", "type": "n8n-nodes-base.stickyNote", "position": [ -1584, 80 ], "parameters": { "color": 7, "width": 360, "height": 596, "content": "## ✅ VALIDATION CHECKPOINT\n\nChecks ALL required conditions:\n\nFrom Webhook:\n1. Name is not empty\n2. Course is not empty\n3. Date is not empty\n\nFrom VerifiEmail:\n4. Email validation = true\n\nAll conditions must pass (AND logic)\n\n✓ TRUE → Continue to Combine Data\n✗ FALSE → Stop workflow with error\n\nAccessing data:\n• Webhook: $('Certificate Request Webhook').item.json.body.field\n• Email: $json.valid" }, "typeVersion": 1 }, { "id": "745c8af8-c38e-4257-968d-c8abeb30e5d3", "name": "Data Combination Info", "type": "n8n-nodes-base.stickyNote", "position": [ -1184, -32 ], "parameters": { "color": 7, "width": 380, "height": 716, "content": "## 🔄 COMBINE WEBHOOK + EMAIL DATA\n\nMerges certificate data with email validation results\n\nInput sources:\n• Webhook data: name, course, date, email, instructor, duration\n• Email validation: valid, provider, MX records\n\nOutput structure:\n```\n{\n name, course, date, email,\n instructor, duration, certificateId,\n emailValidation: {\n valid, provider, rfcCompliant,\n validMxRecord, disposable\n }\n}\n```\nPurpose: Creates clean data structure for HTML generation\n\n⚡ Auto-generates certificateId if not provided\n📅 Keeps original date format for later formatting" }, "typeVersion": 1 }, { "id": "99566da7-4b33-4df0-a280-5a5db861bf13", "name": "HTML Generation Info", "type": "n8n-nodes-base.stickyNote", "position": [ -768, -48 ], "parameters": { "color": 7, "width": 380, "height": 724, "content": "## 🎨 HTML CERTIFICATE GENERATOR\n\nCreates beautiful HTML certificate with:\n\nDesign Features:\n• Purple gradient background (#667eea → #764ba2)\n• Professional typography (Playfair Display + Montserrat)\n• Gold achievement badge with star\n• Clean white certificate with borders\n• Signature section with instructor name\n• Formatted completion date\n\nDynamic Content:\n• Recipient name (large, centered)\n• Course name\n• Completion date (formatted as \"Month Day, Year\")\n• Certificate ID (bottom right)\n• Instructor name (or \"Program Director\" if not provided)\n• Duration (optional, shown if provided)\n\nAuto-generates:\n• Unique Certificate ID if not provided\n• Format: CERT-{timestamp}-{random}\n\nOutput: Complete HTML ready for image conversion" }, "typeVersion": 1 }, { "id": "d2f582b7-9d23-43b9-bc05-e50f96ad122f", "name": "Generate HTML Certificate", "type": "n8n-nodes-base.code", "position": [ -640, 528 ], "parameters": { "jsCode": "// Certificate HTML Generator\nconst items = $input.all();\n\nreturn items.map(item => {\n const data = item.json;\n \n // Generate unique certificate ID if not provided\n const certId = data.certificateId || `CERT-${Date.now()}-${Math.random().toString(36).substr(2, 9).toUpperCase()}`;\n \n // Format date nicely\n const certDate = new Date(data.date).toLocaleDateString('en-US', {\n year: 'numeric',\n month: 'long',\n day: 'numeric'\n });\n \n // HTML Template with inline CSS\n const htmlContent = `\n\n\n\n \n \nThis certifies that
\n\n has successfully completed the course\n
\n \nDuration: ${data.duration}
` : ''}\nYou've successfully completed your course
\nWe're thrilled to celebrate your achievement! You have successfully completed:
\n \nCompletion Date: {{ $('Generate HTML Certificate').item.json.formattedDate }}
\nYour certificate is ready and available for download. Share your accomplishment with your professional network!
\n \n \n \n📋 Certificate Details:
\n💼 Share Your Success:
\nDon't forget to add this certificate to your LinkedIn profile and share it with your network to showcase your new skills!
\n \nIf you have any questions about your certificate, please don't hesitate to reach out to our support team.
\n