SENDGRID n8n INTEGRATION: AUTOMATE SENDGRID WITH N8N

The Send Mail action is the cornerstone of the SendGrid n8n integration. It allows you to send transactional or marketing emails programmatically, triggered by any event in your workflow. This is perfect for welcome emails, order confirmations, password resets, or any automated communication.

Key parameters: The "Credential to connect with" parameter is a required dropdown menu that allows you to select or add your SendGrid account credentials for authentication. The "Resource" parameter is a required dropdown that defines the type of SendGrid API resource to interact with; here, it is set to "Mail". The "Operation" parameter is another required dropdown, specifying the action to perform on the selected resource, and is set to "Send" in this view. For composing the email, the "Sender Email" is a required text field to specify the email address from which the message will be sent. The "Sender Name" is an optional text field for the name associated with the sender email. The "Recipient Email" is a required text field for the primary recipient of the email. The "Subject" is an optional text field for the email's subject line. The "Dynamic Template" is an optional toggle switch that, when enabled, allows the use of SendGrid dynamic templates instead of a plain message body. The "MIME Type" is a required dropdown that determines the content type of the email body. The "Message Body" is a required text area where the actual content of the email is entered. Finally, "Additional Fields" is an optional collapsible section that can be expanded to configure more advanced email parameters.

Use cases:

• Send order confirmation emails when a purchase is completed in your e-commerce platform like WooCommerce
• Trigger password reset emails from your authentication workflow
• Deliver personalized onboarding sequences based on user actions

The Update List action modifies an existing SendGrid mailing list, allowing you to rename lists or update their properties as your segmentation strategy evolves.

Key parameters: The "Credential to connect with" parameter is a required dropdown field that allows you to select your SendGrid account credentials to authenticate the action. The "Resource" parameter is a required dropdown that defines the type of SendGrid entity you want to interact with. Here, "List" is selected, indicating the action will target a mailing list. The "Operation" parameter is another required dropdown that specifies the action to perform on the selected resource. "Update" is currently chosen, meaning this action will modify an existing SendGrid list. The "List ID" parameter is a required text input field where you must provide the unique identifier of the SendGrid mailing list you wish to update. The "Name" parameter is an optional text input field used to specify a new name for the SendGrid mailing list. If provided, the list will be renamed to this value.

Use cases:

• Rename campaign lists after events conclude
• Update list names to reflect current quarter or year
• Standardize naming conventions across your marketing lists

This action fetches multiple mailing lists from your SendGrid account at once, ideal for auditing, synchronization, or building list management interfaces.

Key parameters: The "Credential to connect with" parameter is a required dropdown that allows users to select the SendGrid account to be used for authentication. The "Resource" parameter is a required dropdown that determines the type of SendGrid entity the action will interact with; here, "List" is chosen, indicating operations on contact lists. The "Operation" parameter is a required dropdown that specifies the action to be performed on the selected resource. In this configuration, "Get Many" is selected, meaning the workflow will retrieve multiple contact lists. The "Return All" parameter is an optional toggle. When enabled, it fetches all available records, overriding any specified limit. The "Limit" parameter is an optional number input field that specifies the maximum number of records to retrieve. This parameter is active when "Return All" is disabled.

Use cases:

• Sync all SendGrid lists with your internal database
• Build dropdown menus in custom applications showing available lists
• Audit your mailing lists to identify unused or outdated segments

The Get List action retrieves detailed information about a specific SendGrid mailing list, including its metadata and optionally a sample of contacts.

Key parameters: The "Credential to connect with" parameter is a required dropdown used to select the SendGrid account credentials for authenticating the action. The "Resource" parameter is another required dropdown, which defines the type of SendGrid entity the automation will interact with; "List" is currently selected, indicating operations on contact lists. The "Operation" parameter is also a required dropdown, specifying the particular action to perform on the chosen Resource. "Get" is selected, meaning the workflow will retrieve data. The "List ID" parameter is a text input field, which is required when the Resource is set to "List" and the Operation is "Get". This field is used to input the unique identifier of the specific SendGrid contact list to be retrieved. Finally, "Contact Sample" is an optional toggle switch. When enabled, it will likely include a sample of contacts from the retrieved list in the action's output.

Use cases:

• Verify list details before adding new contacts
• Check list size and metadata for reporting purposes
• Pull list information to display in dashboards or admin interfaces

The Delete List action removes a mailing list from your SendGrid account, with an optional parameter to also delete all associated contacts.

Key parameters: The "Credential to connect with" parameter is a dropdown menu that allows you to select which SendGrid account connection to use for this action. This parameter is required. The "Resource" parameter is a dropdown to specify the type of SendGrid entity you want to interact with. Here, "List" is selected, indicating that the action will target a SendGrid contact list. This is a required parameter. The "Operation" parameter is another dropdown that defines the specific action to perform on the chosen resource. For the "List" resource, "Delete" is selected, meaning this action will delete a SendGrid list. This parameter is also required. The "List ID" parameter is a text input field where you must provide the unique identifier of the SendGrid list you wish to delete. This parameter is required for the "Delete" operation on a list. The "Delete Contacts" parameter is an optional toggle switch. When enabled, it allows you to also delete all contacts associated with the list when the list itself is deleted.

Use cases:

• Clean up temporary campaign lists after completion
• Remove test lists from production environments
• Archive old segments by deleting outdated lists

The Create List action lets you programmatically create new mailing lists in SendGrid, enabling dynamic audience segmentation based on your workflow logic.

Key parameters: The "Credential to connect with" parameter is a required dropdown field used to select your pre-configured SendGrid account credentials. The "Resource" parameter, also a required dropdown, defines the type of SendGrid entity this action will interact with. Here, it is set to "List", indicating the action will work with SendGrid marketing lists. The "Operation" parameter, a required dropdown, specifies the action to be performed on the selected resource. Currently, it is set to "Create", meaning this action will create a new list. Finally, the "Name" parameter is a required text input field where you define the name for the new SendGrid list. This field supports both fixed text values and expressions for dynamic naming.

Use cases:

• Automatically create event-specific lists when launching new campaigns
• Generate segment lists based on product categories or user behaviors
• Build regional mailing lists dynamically as you expand to new markets

This bulk retrieval action fetches multiple contacts from your SendGrid account, with optional filtering to narrow down results.

Key parameters: The "Credential to connect with" parameter is a required dropdown field used to select the SendGrid account connection for this action. The "Resource" parameter is another required dropdown, allowing users to choose the specific SendGrid resource to interact with. Here, "Contact" is selected, indicating the action will operate on SendGrid contacts. The "Operation" parameter is a required dropdown that defines the specific action to be performed on the selected resource. For the "Contact" resource, "Get Many" is currently chosen, meaning the workflow will fetch multiple contact records. Below these, the "Return All" parameter is an optional toggle switch. When enabled, it retrieves all available records that match the criteria. When disabled, it allows you to specify a maximum number of records to retrieve. The "Limit" parameter is an optional text input field that becomes visible when "Return All" is disabled. It accepts a numerical value to specify the maximum number of records to return. Finally, the "Filters" section is an optional area where users can add conditions to refine the search for contacts. It includes an "Add Field" button, allowing users to define specific criteria (e.g., by email, custom field) to narrow down the list of contacts retrieved by the "Get Many" operation.

Use cases:

• Export contacts for analysis in spreadsheets or BI tools
• Sync SendGrid contacts to your CRM or data warehouse
• Build contact search functionality in custom applications

The Get Contact action retrieves detailed information about a specific contact from your SendGrid account, useful for verification or data enrichment workflows.

Key parameters: The "Credential to connect with" parameter is a required dropdown that allows you to select an existing SendGrid account connection for authentication. The "Resource" parameter is a required dropdown used to specify the type of SendGrid entity you want to interact with; here, "Contact" is chosen. The "Operation" parameter, also a required dropdown, defines the action to be performed on the selected resource. In this configuration, "Get" is selected, indicating the module will retrieve contact information. Following the selection of the "Get" operation, the "By" parameter appears as a required dropdown to specify how the contact will be identified. It is currently set to "ID", meaning the contact will be looked up using their unique identifier. Finally, the "Contact ID" parameter is a required text field where you must enter the specific ID of the contact you wish to retrieve from SendGrid.

Use cases:

• Verify contact exists before triggering email sequences
• Pull contact details for personalization in downstream actions
• Check contact status and custom field values

The Delete Contact action removes contacts from your SendGrid account, either individually by ID or in bulk.

Key parameters: This action allows you to delete contacts within your SendGrid account. The "Credential to connect with" parameter is a required dropdown field used to select the SendGrid account credentials for authentication. The "Resource" parameter is another required dropdown, specifying the type of SendGrid entity to operate on; here, it's set to "Contact". The "Operation" parameter, also a required dropdown, defines the specific action to perform on the selected resource, and it's currently set to "Delete". Below these, the "Contact IDs" parameter is a text input field where you can provide the unique identifiers of the contacts you wish to delete. This field expects a list of contact IDs and is typically required when "Delete All" is not enabled. Lastly, the "Delete All" parameter is an optional toggle switch. When enabled, it instructs the action to delete all contacts in your SendGrid account, overriding the need to specify individual "Contact IDs".

Use cases:

• Remove unsubscribed users from your database
• Clean up bounced or invalid email addresses
• Process GDPR deletion requests automatically

This upsert action either creates a new contact or updates an existing one based on the email address, making it perfect for maintaining accurate contact data.

Key parameters: The "Credential to connect with" parameter is a required dropdown field used to select the SendGrid account credentials for authentication. The "Resource" parameter, also a required dropdown, specifies the type of entity within SendGrid that the action will interact with; in this screenshot, "Contact" is selected, indicating the action targets SendGrid contacts. The "Operation" parameter is another required dropdown that defines the specific action to perform on the chosen resource. Here, "Create or Update" is selected, meaning the workflow will either create a new contact or update an existing one based on the provided email address. The "Email" parameter is a required text input field where you provide the email address for the contact being created or updated. Finally, "Additional Fields" is an optional section where you can add further properties for the contact, such as first name, last name, or custom fields, by clicking the "Add Field" button.

Use cases:

• Add new newsletter subscribers from your website forms
• Update contact information when users modify their profiles
• Sync customer data from your CRM to SendGrid automatically using tools like Airtable