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 customer engagement workflows. For example, you can use this node to add new subscribers collected from a web form directly into your SendGrid contact database.
Properties
| Name | Meaning |
|---|---|
| The primary email address of the contact to be created. | |
| Additional Fields | Optional extra information about the contact. Available options: 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 any errors encountered.
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
- Common issues:
- Invalid or missing API key will cause authentication failures.
- Providing an invalid email format may result in API errors.
- Network connectivity problems can prevent the request from completing.
- Error messages:
- Authentication errors typically indicate issues with the API key; verify the key and permissions.
- Validation errors from the API often specify which fields are incorrect; ensure the email and additional fields conform to expected formats.
- HTTP errors (e.g., 4xx or 5xx) suggest issues with the request or server; check the request payload and retry if needed.