# SendGrid AI integration on Definable

> SendGrid is a cloud-based email delivery platform providing transactional and marketing email services, with APIs for integration, analytics, and scalability

## What this connects

SendGrid is a cloud-based email delivery platform providing transactional and marketing email services, with APIs for integration, analytics, and scalability

Vendor: https://login.sendgrid.com

## Tools available

**359** tools available. First 12:

- `SENDGRID_ACTIVATE_TEMPLATE_VERSION` — Activate template version — Activates a specific version of a transactional template, making it the default version used when sending emails. Only one version can be active at a time per template. When you activate a version, any previously active version becomes inactive. The activated version's content (HTML, plain text, subject) will be used for all emails sent using this template until a different version is activated. Use this endpoint to switch between template versions for A/B testing, rollbacks, or deploying new email designs.
- `SENDGRID_ADD_A_BATCH_OF_IPS_TO_AN_IP_POOL` — Add a batch of ips to an ip pool — Adds a batch of IP addresses to a specified IP Pool in SendGrid. This operation appends multiple IPs to an existing IP Pool. All IP assignments must succeed for the operation to complete - if any single IP assignment fails, the entire operation will return an error. Requirements: - A SendGrid account with dedicated IP addresses (Pro or Premier plan) - API key with 'IP Address Management' permissions - Valid pool ID and IP addresses that exist in your SendGrid account - Each IP Pool can have a maximum of 100 IPs Note: This endpoint is part of the IP Address Management API which is currently in public beta.
- `SENDGRID_ADD_AN_IP_ADDRESS_TO_A_POOL` — Add an ip address to a pool — Adds a dedicated IP address to an IP pool in your SendGrid account. **Prerequisites:** - You must have a SendGrid Pro or Premier plan with dedicated IP addresses - The IP address must be activated in your SendGrid account (Settings > IP Addresses > Edit > "Allow my account to send mail using this IP address") - A reverse DNS record must be set up for the IP address - The IP pool must already exist (create one first if needed) **Key Features:** - An IP address can be added to multiple pools simultaneously - Changes may take up to 60 seconds to propagate - Returns the IP's warmup status and all pools it's assigned to **Common Use Cases:** - Segregate transactional and marketing email to different IP pools - Organize IPs by brand, customer, or email type for reputation management - Set up dedicated sending infrastructure for high-volume senders
- `SENDGRID_ADD_AN_IP_TO_AN_AUTHENTICATED_DOMAIN` — Add an ip to an authenticated domain — Add an IP address to an authenticated domain for custom SPF configuration. This endpoint associates a dedicated IP address with an authenticated domain, which is useful for manually specifying IPs in your custom SPF record. The authenticated domain (formerly called 'domain whitelabel') allows you to remove the 'via' or 'sent on behalf of' message from your emails. **Prerequisites:** - The domain must already be authenticated (created via Authenticate a Domain endpoint) - The IP must be a dedicated IP address belonging to your SendGrid account - Your API key must have 'whitelabel.update' and appropriate IP permissions **Returns:** The updated authenticated domain object with the IP added to the 'ips' array.
- `SENDGRID_ADD_A_SINGLE_RECIPIENT_TO_A_LIST` — Add a single recipient to a list — Adds a single recipient to a contact list in SendGrid's Legacy Contact Database. IMPORTANT: This uses the deprecated Legacy API (/v3/contactdb/). Many accounts no longer have access and will receive 403 errors. Use PUT /v3/marketing/contacts instead. Prerequisites: The recipient and list must already exist in your database. Parameters: - list_id: Numeric list ID from 'create_a_list' or 'retrieve_all_lists' - recipient_id: Base64-encoded lowercase email (e.g., 'test@example.com' → 'dGVzdEBleGFtcGxlLmNvbQ==') Returns: Empty dict {} on success (HTTP 201), or error details with status_code, message, and hint for troubleshooting.
- `SENDGRID_ADD_A_TWILIO_SEND_GRID_IP_ADDRESS` — Add a twilio sendgrid ip address — Provisions a new Twilio SendGrid IP address to your account. This endpoint adds (purchases) a dedicated IP address to your SendGrid account. You can optionally: - Enable automatic warmup to gradually increase sending volume - Assign the IP to the parent account for sending email - Assign up to 100 Subusers to the IP address at creation - Specify the region (global/US or EU) for the IP address Important Requirements: - Requires a Pro or Premier SendGrid account (not available for Free/Essential plans) - Requires API key with Billing permissions (mutually exclusive from other permissions) - Additional IPs cost $30/month per IP - Parent must be assigned before the IP can be added to IP pools or used for sending Note: This is a billing operation that will incur charges on your SendGrid account.
- `SENDGRID_ADD_IPS` — Add ips — Add dedicated IP addresses to your SendGrid account. This endpoint provisions new dedicated IP addresses for sending emails. Dedicated IPs give you full control over your sender reputation and are recommended for high-volume senders. Note: This endpoint requires the 'ips.create' API key scope and may require an appropriate SendGrid plan that supports dedicated IPs.
- `SENDGRID_ADD_ONE_OR_MORE_IPS_TO_THE_ALLOW_LIST` — Add one or more ips to the allow list — Adds one or more IPv4 addresses to your SendGrid account's IP access management allow list. Once enabled, only requests from these IPs can access SendGrid UI, API, and SMTP relay. Each IP is assigned a unique ID for future removal. Supports single IPs, CIDR notation (e.g., '192.168.1.0/24'), and wildcards (e.g., '192.*.*.*'). SendGrid limits the total allowed IPs to 1000. Note: IPv6 addresses are not supported. Warning: Be careful not to add IPs that exclude your own, as this could block your access.
- `SENDGRID_ADD_OR_UPDATE_A_CONTACT` — Add or update a contact — Adds or updates contacts in SendGrid Marketing Campaigns. This is an asynchronous operation that queues contacts for processing. Returns a job_id to track the import status. Contacts are matched by identifier (email, phone_number_id, external_id, or anonymous_id) - existing contacts are updated, new ones are created. Email addresses are automatically lowercased. Max 30,000 contacts or 6MB per request.
- `SENDGRID_ADD_SUPPRESSIONS_TO_A_SUPPRESSION_GROUP` — Add suppressions to a suppression group — **This endpoint allows you to add email addresses to an unsubscribe group.** If you attempt to add suppressions to a group that has been deleted or does not exist, the suppressions will be added to the global suppressions list.
- `SENDGRID_ADD_TO_GLOBAL_SUPPRESSIONS_GROUP` — Add recipient addresses to the global suppression group — Adds one or more email addresses to the global suppression group. Email addresses added to this group will no longer receive any emails from your SendGrid account. This is useful for managing recipients who have opted out of all communications or for ensuring certain addresses never receive emails. The action is idempotent - adding an email that is already suppressed will succeed without error. Returns the list of email addresses that were processed.
- `SENDGRID_APPROVE_ACCESS_REQUEST` — Approve access request — **This endpoint allows you to approve an access attempt.** **Note:** Only teammate admins may approve another teammate’s access request.

## Auth

Auth schemes: `API_KEY`.

## How agents use SendGrid

Inside a Definable workflow, SendGrid is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → SendGrid** — the Researcher (GPT-5.5) pulls context from SendGrid (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → SendGrid** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into SendGrid (create record, post message, draft email).
- **Designer / Engineer → Distributor → SendGrid** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via SendGrid (attach file, open PR comment, post status).

The Verifier checks every SendGrid call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- transactional email — https://definable.ai/apps/category/transactional-email/
- email newsletters — https://definable.ai/apps/category/email-newsletters/

## Related

- HTML page: https://definable.ai/apps/sendgrid/
- Same category (transactional email): https://definable.ai/apps/category/transactional-email/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt