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 for segmentation or personalization.
Example use case: Automatically create a new contact when a user signs up on a website, assign them to relevant mailing lists, and set their first name and phone number as attributes.
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 added. Users can select from existing lists or provide expressions to specify lists dynamically. This is required. |
| Default Attributes | Optional collection of predefined attributes to set on the contact. Available attributes include: First Name, Last Name, Phone Number, and Prefix. Each attribute requires a value. |
| Custom Attributes | Optional collection of custom attributes to set on the contact. Users can choose attribute names or IDs from a dynamic list or specify them via expressions, along with corresponding values. |
Output
The node outputs JSON data representing the newly created contact. This typically includes the contact's ID, email, assigned lists, and all set attributes (both default and custom). The output structure enables downstream nodes to access the contact details for further processing.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the Autocust service.
- Relies on Autocust API endpoints to create contacts, retrieve lists, and fetch attribute metadata.
- The node uses dynamic loading methods to populate selectable options for lists and attributes.
Troubleshooting
- Missing Required Fields: If the "Contact Email" or "List Names" are not provided, the node will throw an error indicating missing required parameters. Ensure these fields are filled.
- Invalid List Names: Selecting or specifying non-existent list names may cause API errors. Use the dynamic list selector or verify list names beforehand.
- Attribute Value Issues: Providing invalid or empty values for required attributes might result in incomplete contact creation or API rejection.
- API Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions to create contacts.
- Unknown Operation Error: If the operation parameter is incorrectly set, the node will report an unknown operation error.
Links and References
- n8n Expressions Documentation
- Autocust API documentation (refer to your service provider's official docs for detailed API usage)