Overview
This node integrates with the SendGrid Marketing Contacts API to create new contact entries. It is designed to add contacts by specifying their email and optional additional details such as first and last names. This node is useful in marketing automation workflows where you want to programmatically manage your contact lists, for example, adding new subscribers collected from a web form or syncing contacts from another system.
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 contacts. Each element corresponds to one input item processed. The JSON typically contains status information about the contact creation request.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the SendGrid API.
- The node makes HTTP requests to
https://api.sendgrid.com/v3/marketing/contacts. - Proper configuration of the API key credential within n8n is necessary for successful execution.
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 node from reaching the SendGrid API.
- Error messages:
- Authentication errors usually indicate issues with the API key; verify that the key is correct and has appropriate permissions.
- Validation errors from the API often relate to malformed input data; ensure the email and other fields conform to expected formats.
- HTTP errors (e.g., 4xx or 5xx) suggest issues on client or server side; check the request payload and retry later if needed.