SendGrid

Usage Instructions

Integrate SendGrid into your workflow. Send transactional emails, manage marketing contacts and lists, and work with email templates. Supports dynamic templates, attachments, and comprehensive contact management.

Tools

`sendgrid_send_mail`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`from`	string	Yes	No description
`fromName`	string	No	No description
`to`	string	Yes	No description
`toName`	string	No	No description
`subject`	string	No	No description
`content`	string	No	No description
`contentType`	string	No	No description
`cc`	string	No	No description
`bcc`	string	No	No description
`replyTo`	string	No	No description
`replyToName`	string	No	No description
`attachments`	file[]	No	No description
`templateId`	string	No	No description
`dynamicTemplateData`	json	No	No description

Output

Parameter	Type	Description
`success`	boolean	Whether the email was sent successfully
`messageId`	string	SendGrid message ID
`to`	string	to output from the tool
`subject`	string	Email subject

`sendgrid_add_contact`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`email`	string	Yes	No description
`firstName`	string	No	No description
`lastName`	string	No	No description
`customFields`	json	No	JSON object of custom field key-value pairs (use field IDs like e1_T, e2_N, e3_D, not field names)
`listIds`	string	No	No description

Output

Parameter	Type	Description
`jobId`	string	Job ID for tracking the async contact creation
`email`	string	email output from the tool
`firstName`	string	firstName output from the tool
`lastName`	string	lastName output from the tool
`message`	string	Status message

`sendgrid_get_contact`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`contactId`	string	Yes	No description

Output

Parameter	Type	Description
`id`	string	Contact ID
`email`	string	Contact email address
`firstName`	string	Contact first name
`lastName`	string	Contact last name
`createdAt`	string	Creation timestamp
`updatedAt`	string	Last update timestamp
`listIds`	json	Array of list IDs the contact belongs to
`customFields`	json	Custom field values

`sendgrid_search_contacts`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`query`	string	Yes	Search query (e.g., "email LIKE '%example.com%' AND CONTAINS(list_ids, 'list-id')")

Output

Parameter	Type	Description
`contacts`	json	Array of matching contacts
`contactCount`	number	Total number of contacts found

`sendgrid_delete_contacts`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`contactIds`	string	Yes	No description

Output

Parameter	Type	Description
`jobId`	string	Job ID for the deletion request

`sendgrid_create_list`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`name`	string	Yes	No description

Output

Parameter	Type	Description
`id`	string	List ID
`name`	string	name output from the tool
`contactCount`	number	Number of contacts in the list

`sendgrid_get_list`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`listId`	string	Yes	No description

Output

Parameter	Type	Description
`id`	string	List ID
`name`	string	List name
`contactCount`	number	Number of contacts in the list

`sendgrid_list_all_lists`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`pageSize`	number	No	No description

Output

Parameter	Type	Description
`lists`	json	Array of lists

`sendgrid_delete_list`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`listId`	string	Yes	No description

Output

Parameter	Type	Description
`message`	string	Success message

`sendgrid_add_contacts_to_list`

Add or update contacts and assign them to a list in SendGrid (uses PUT /v3/marketing/contacts)

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`listId`	string	Yes	No description
`contacts`	json	Yes	JSON array of contact objects. Each contact must have at least: email (or phone_number_id/external_id/anonymous_id). Example: [{"email": "user@example.com", "first_name": "John"}]

Output

Parameter	Type	Description
`jobId`	string	Job ID for tracking the async operation
`message`	string	Status message

`sendgrid_remove_contacts_from_list`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`listId`	string	Yes	No description
`contactIds`	string	Yes	No description

Output

Parameter	Type	Description
`jobId`	string	Job ID for the request

`sendgrid_create_template`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`name`	string	Yes	No description
`generation`	string	No	No description

Output

Parameter	Type	Description
`id`	string	Template ID
`name`	string	name output from the tool
`generation`	string	Template generation
`updatedAt`	string	Last update timestamp
`versions`	json	Array of template versions

`sendgrid_get_template`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`templateId`	string	Yes	No description

Output

Parameter	Type	Description
`id`	string	Template ID
`name`	string	Template name
`generation`	string	Template generation
`updatedAt`	string	Last update timestamp
`versions`	json	Array of template versions

`sendgrid_list_templates`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`generations`	string	No	No description
`pageSize`	number	No	No description

Output

Parameter	Type	Description
`templates`	json	Array of templates

`sendgrid_delete_template`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`templateId`	string	Yes	No description

Output

Parameter	Type	Description
`success`	boolean	Operation success status
`message`	string	Status or success message
`messageId`	string	Email message ID (send_mail)
`to`	string	Recipient email address (send_mail)
`subject`	string	Email subject (send_mail, create_template_version)
`id`	string	Resource ID
`jobId`	string	Job ID for async operations
`email`	string	Contact email address
`firstName`	string	Contact first name
`lastName`	string	Contact last name
`createdAt`	string	Creation timestamp
`updatedAt`	string	Last update timestamp
`listIds`	json	Array of list IDs the contact belongs to
`customFields`	json	Custom field values
`contacts`	json	Array of contacts
`contactCount`	number	Number of contacts
`lists`	json	Array of lists
`name`	string	Resource name
`templates`	json	Array of templates
`generation`	string	Template generation
`versions`	json	Array of template versions
`templateId`	string	Template ID
`active`	boolean	Whether template version is active
`htmlContent`	string	HTML content
`plainContent`	string	Plain text content

`sendgrid_create_template_version`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`templateId`	string	Yes	No description
`name`	string	Yes	No description
`subject`	string	Yes	No description
`htmlContent`	string	No	No description
`plainContent`	string	No	No description
`active`	boolean	No	No description

Output

Parameter	Type	Description
`id`	string	Version ID
`templateId`	string	templateId output from the tool
`name`	string	name output from the tool
`subject`	string	Email subject
`active`	boolean	Whether this version is active
`htmlContent`	string	HTML content
`plainContent`	string	Plain text content
`updatedAt`	string	Last update timestamp

SendGrid

On this page