
About
Automate SendGrid email delivery workflows including marketing campaigns (Single Sends), contact and list management, sender identity setup, and email analytics through Composio's SendGrid toolkit.
name: sendgrid-automation description: "Automate SendGrid email delivery workflows including marketing campaigns (Single Sends), contact and list management, sender identity setup, and email analytics through Composio's SendGrid toolkit." risk: critical source: community date_added: "2026-02-27"
SendGrid Automation via Rube MCP
Automate SendGrid email delivery workflows including marketing campaigns (Single Sends), contact and list management, sender identity setup, and email analytics through Composio's SendGrid toolkit.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active SendGrid connection via
RUBE_MANAGE_CONNECTIONSwith toolkitsendgrid - Always call
RUBE_SEARCH_TOOLSfirst to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLSresponds - Call
RUBE_MANAGE_CONNECTIONSwith toolkitsendgrid - If connection is not ACTIVE, follow the returned auth link to complete SendGrid API key authentication
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Create and Send Marketing Campaigns (Single Sends)
When to use: User wants to create and send a marketing email campaign to a contact list or segment.
Tool sequence:
SENDGRID_RETRIEVE_ALL_LISTS- List available marketing lists to target [Prerequisite]SENDGRID_CREATE_A_LIST- Create a new list if needed [Optional]SENDGRID_ADD_OR_UPDATE_A_CONTACT- Add contacts to the list [Optional]SENDGRID_GET_ALL_SENDER_IDENTITIES- Get verified sender ID [Prerequisite]SENDGRID_CREATE_SINGLE_SEND- Create the campaign with content, sender, and recipients [Required]
Key parameters for SENDGRID_CREATE_SINGLE_SEND:
name: Campaign name (required)email__config__subject: Email subject lineemail__config__html__content: HTML body contentemail__config__plain__content: Plain text versionemail__config__sender__id: Verified sender identity IDemail__config__design__id: Use instead of html_content for pre-built designssend__to__list__ids: Array of list UUIDs to send tosend__to__segment__ids: Array of segment UUIDssend__to__all: true to send to all contactsemail__config__suppression__group__idoremail__config__custom__unsubscribe__url: One required for compliance
Pitfalls:
- Setting
send_aton CREATE does NOT schedule the send; it only prepopulates the UI date; use the Schedule endpoint separately send_at: "now"is only valid with the Schedule endpoint, not CREATE- Must provide either
suppression_group_idorcustom_unsubscribe_urlfor unsubscribe compliance - Sender must be verified before use; check with
SENDGRID_GET_ALL_SENDER_IDENTITIES - Nested params use double-underscore notation (e.g.,
email__config__subject)
2. Manage Contacts and Lists
When to use: User wants to create contact lists, add/update contacts, search for contacts, or remove contacts from lists.
Tool sequence:
SENDGRID_RETRIEVE_ALL_LISTS- List all marketing lists [Required]SENDGRID_CREATE_A_LIST- Create a new contact list [Optional]SENDGRID_GET_A_LIST_BY_ID- Get list details and sample contacts [Optional]SENDGRID_ADD_OR_UPDATE_A_CONTACT- Upsert contacts with list association [Required]SENDGRID_GET_CONTACTS_BY_EMAILS- Look up contacts by email [Optional]SENDGRID_GET_CONTACTS_BY_IDENTIFIERS- Look up contacts by email, phone, or external ID [Optional]SENDGRID_GET_LIST_CONTACT_COUNT- Verify contact count after operations [Optional]SENDGRID_REMOVE_CONTACTS_FROM_A_LIST- Remove contacts from a list without deleting [Optional]SENDGRID_REMOVE_LIST_AND_OPTIONAL_CONTACTS- Delete an entire list [Optional]SENDGRID_IMPORT_CONTACTS- Bulk import from CSV [Optional]
Key parameters for SENDGRID_ADD_OR_UPDATE_A_CONTACT:
contacts: Array of contact objects (max 30,000 or 6MB), each with at least one identifier:email,phone_number_id,external_id, oranonymous_id(required)list_ids: Array of list UUID strings to associate contacts with
Pitfalls:
SENDGRID_ADD_OR_UPDATE_A_CONTACTis asynchronous; returns 202 withjob_id; contacts may take 10-30 seconds to appear- List IDs are UUIDs (e.g., "ca7a3796-e8a8-4029-9ccb-df8937940562"), not integers
- List names must be unique; duplicate names cause 400 errors
SENDGRID_ADD_A_SINGLE_RECIPIENT_TO_A_LISTuses the legacy API; preferSENDGRID_ADD_OR_UPDATE_A_CONTACTwithlist_idsSENDGRID_REMOVE_LIST_AND_OPTIONAL_CONTACTSis irreversible; require explicit user confirmation- Email addresses are automatically lowercased by SendGrid
3. Manage Sender Identities
When to use: User wants to set up or view sender identities (From addresses) for sending emails.
**Too
