Overview
The node provides operations to manage contacts within the Autocust system. Specifically, the Create Contact operation allows users to add a new contact by specifying their email, assigning them to one or more lists, and optionally setting default and custom attributes for that contact.
This node is beneficial in scenarios such as:
- Adding new subscribers or customers to marketing or CRM lists.
- Automating contact creation from form submissions or other data sources.
- Enriching contact profiles with additional attributes during creation.
For example, you can use this node to create a contact with an email address, assign them to specific mailing lists, and set attributes like first name, last name, and phone number all in one step.
Properties
| Name | Meaning |
|---|---|
| Contact Email | The email address of the contact to create. This is required and uniquely identifies the contact. |
| List Names | One or more list names to which the contact will be assigned. You can select from existing lists or use expressions to specify them dynamically. |
| Default Attributes | Optional collection of predefined attributes to set on the contact, such as First Name, Last Name, Phone Number, and Prefix. Multiple attributes can be added. |
| Custom Attributes | Optional collection of custom attributes to set on the contact. You can choose attribute names or IDs from a list or specify them via expressions. Multiple custom attributes can be added. |
Output
The node outputs JSON data representing the newly created contact. This typically includes the contact's ID, email, assigned lists, and any attributes set during creation. The output structure allows downstream nodes to access the contact details for further processing.
There is no indication that the node outputs binary data.
Dependencies
- Requires an API key credential for authenticating with the Autocust service.
- Depends on Autocust API endpoints to create contacts, retrieve lists, and fetch attribute metadata.
- Uses internal methods to load options dynamically for lists and attributes.
Troubleshooting
Common Issues:
- Missing or invalid email address will cause the creation to fail.
- Specifying list names that do not exist or are misspelled may result in errors or the contact not being assigned correctly.
- Providing invalid attribute names or values might cause the API to reject the request.
Error Messages:
"The operation 'createContact' is not known!"— indicates an unsupported operation was selected; ensure "Create Contact" is chosen.- API errors related to authentication failures suggest checking the configured API key credential.
- Validation errors about required fields (like email or lists) mean those inputs must be provided.
To resolve issues, verify all required fields are filled correctly, ensure the API credentials are valid, and confirm that list and attribute names match those available in the Autocust system.
Links and References
- n8n Expressions Documentation — for using expressions in property fields.
- Autocust API documentation (not provided here) would be useful for understanding attribute names, list management, and error codes.