sendgrid_skill

Overview

This skill lets you send transactional and marketing emails using the SendGrid API. It supports templates, attachments, personalization, and basic email analytics for tracking delivery and engagement. Configure with an API key to start sending at scale.

How this skill works

The skill issues authenticated HTTP requests to SendGrid endpoints to create and send messages, apply dynamic templates, and fetch template lists or stats. You provide personalizations, template IDs, attachments, and content, and the skill formats the payload and forwards it to SendGrid. It can also query the stats and templates endpoints to retrieve usage and template metadata.

When to use it

• Send transactional emails like receipts, password resets, or order confirmations.
• Deliver marketing or promotional campaigns using dynamic templates.
• Attach files or include multiple content types (HTML and plain text).
• Automate email delivery from backend services or serverless functions.
• Retrieve send metrics for analytics and reporting.

Best practices

• Store the SENDGRID_API_KEY securely in environment variables or a secrets manager.
• Use dynamic templates to separate content from code and simplify localization.
• Include both text/plain and text/html parts for best inbox rendering.
• Monitor delivery and engagement via the stats endpoint and handle bounces or suppressions.
• Rate-limit requests and implement retry logic for transient API errors.

Example use cases

• Send an order confirmation using a dynamic template with order_id and customer name.
• Trigger a password reset email with a secure one-time link from a backend job.
• Bulk-send a marketing announcement while tracking opens and clicks via stats.
• Attach invoices or PDFs to transactional messages for customers.
• List available dynamic templates to let admins choose templates in an app.