Prerequisites
- You must be a workspace admin.
- You need a SendGrid API key with Mail Send and Template Engine permissions.
Step 1 — Create your SendGrid API key
- Log in to SendGrid
- Go to Settings → API Keys
- Click Create API Key
- Select Restricted Access and enable:
- Mail Send → Full Access
- Template Engine → Full Access
- Copy the generated key
Step 2 — Add SendGrid in Mailkick
- Open Settings → Integrations
- Select SendGrid
- Paste your API key
- Click Save changes
Step 3 — Sync an email
- Open an email in the editor
- Click Export
- Click Sync to SendGrid
https://mc.sendgrid.com/dynamic-templates/{template_id}/version/{version_id}/editor
How sync works
When you sync an email to SendGrid:- First sync → Creates a new Dynamic Template with a version
- Subsequent syncs → Updates the existing version (idempotent via content hash)
- Template deleted on SendGrid → Mailkick automatically recreates it
Mailkick uses content hashing to avoid unnecessary API calls. If the HTML hasn’t changed, no update is sent.
Using Dynamic Templates
SendGrid Dynamic Templates support Handlebars variables. In your email, you can use:Common issues
| Error | Cause | Solution |
|---|---|---|
sendgrid_not_configured | No API key saved | Add your API key in Settings → Integrations |
sendgrid_missing_api_key | API key was deleted | Re-add your API key |
sendgrid_sync_failed | API error | Check API key permissions (Template Engine required) |
sendgrid_http_401 | Invalid API key | Generate a new API key in SendGrid |
sendgrid_http_403 | Insufficient permissions | Enable Template Engine access on your key |
