SendGrid Connector
Connect Zenmako to SendGrid to send transactional emails, manage email templates, and maintain marketing contact lists directly through AI-powered workflows.
Getting Your API Key
SendGrid uses API Keys for authentication. Follow these steps to create one:
Log in to your SendGrid account at app.sendgrid.com
Go to Settings > API Keys in the left sidebar
Click Create API Key
Give your key a name (e.g., "Zenmako Integration")
Select the access level:
- Full Access: Grants all permissions (simplest option)
- Restricted Access: Select specific permissions (recommended for security):
- Mail Send: Full Access (required for sending emails)
- Template Engine: Read Access (required for listing/viewing templates)
- Marketing > Contacts: Full Access (required for contact management)
- Marketing > Lists: Full Access (required for list management)
Click Create & View
Copy the API Key that is displayed
Store your API key securely. SendGrid only shows it once. If you lose it, you will need to create a new one.
Connecting SendGrid
Navigate to the Connections page in Zenmako
Click Add Connection and select SendGrid
Enter your credentials:
- API Key: Paste the API Key you generated
Click Save
Click Test Connection to verify the setup works
If the test succeeds, your SendGrid connection is ready to use.
Available Actions
Email
| sendEmail | Send an email with full customization (to, from, subject, content, cc, bcc, reply-to, categories) |
| sendWithDynamicTemplate | Send an email using a SendGrid dynamic template with template data |
Templates
| listTemplates | List all available SendGrid email templates (supports filtering by legacy or dynamic type) |
| getTemplate | Get details of a specific template including all versions |
Contacts
| addOrUpdateContact | Add new contacts or update existing contacts in SendGrid Marketing Campaigns |
| addContactsToList | Add existing contacts to a specific list |
Lists
| getAllLists | Get all contact lists from SendGrid Marketing Campaigns |
| getListById | Get details of a specific contact list including optional contact sample |
Example Prompts
Try these prompts to interact with SendGrid:
"Send an email to john@example.com from sales@mycompany.com with subject 'Welcome!' and body 'Thanks for signing up.'"
"List all my SendGrid email templates"
"Send a welcome email to jane@example.com using the template d-abc123 with first_name set to Jane"
"Add a new contact with email mike@example.com, first name Mike, and last name Johnson to my marketing list"
"Show me all my contact lists in SendGrid"
Common Issues
"SendGrid API error: 401 Unauthorized" error
This typically means your API key is invalid or has been revoked. Solutions:
Verify you copied the complete API key without extra spaces
Check that the API key has not been deleted in SendGrid Settings
Ensure the API key has the required permissions for the action you are performing
Generate a new API key if needed
Emails not being delivered
If emails are sent successfully but not received:
Check your SendGrid Activity Feed for delivery status and any bounce/block information
Verify your sender email address is authenticated (check Sender Authentication in SendGrid)
Review your domain DNS settings for SPF/DKIM configuration
Check if the recipient email is on your suppression list
Zenmako