Overview
This node integrates with the SendGrid API to create new marketing contacts. It is useful for automating the addition of contacts into a SendGrid marketing list, enabling email campaigns and contact management directly from an n8n workflow. For example, after collecting user sign-up data on a website, this node can add the user's email and optional personal details to SendGrid for future email marketing.
Properties
| Name | Meaning |
|---|---|
| The primary email address of the contact to be created. | |
| Additional Fields | Optional extra information about the contact. Includes: First Name, Last Name. |
Output
The node outputs an array of JSON objects representing the response from the SendGrid API after attempting to create the contact(s). Each object corresponds to one execution item and contains the API's response data confirming the creation or providing error details.
Dependencies
- Requires an API key credential for authenticating with the SendGrid API.
- The node makes HTTP PUT requests to
https://api.sendgrid.com/v3/marketing/contacts. - Proper configuration of the API key credential in n8n is necessary for successful authentication.
Troubleshooting
- Authentication errors: If the API key is invalid or missing, the request will fail. Ensure the API key credential is correctly set up.
- Invalid email format: The API may reject improperly formatted emails. Validate email addresses before input.
- API rate limits: Excessive requests might lead to throttling by SendGrid. Implement error handling or delays if processing large batches.
- Missing required fields: The "Email" property is mandatory; omitting it will cause errors.