Actions20
- Contact Actions
- Contact Tagging Actions
- Data Field Actions
- Opt-In Process Actions
- Tag Actions
Contact → Add or Update Contact
AI-generatedOverview
This node operation adds a new contact or updates an existing contact in the system based on the provided email address or SMS number. It is useful for managing subscriber lists by ensuring that contacts are either created or updated without duplication. Typical use cases include email marketing, SMS campaigns, and customer relationship management where maintaining up-to-date contact information is essential.
Use Case Examples
- Adding a new subscriber to an email list with their email address and custom data fields.
- Updating an existing subscriber's SMS number and tagging them for targeted SMS campaigns.
Properties
| Name | Meaning |
|---|---|
| Email Address | The email address of the contact to add or update. |
| SMS Number | The SMS number of the contact to add or update. |
| Opt-in Process | The ID of the opt-in process to associate with the contact, selectable from a list or via expression. |
| Tag | The ID of the tag to assign to the contact, selectable from a list or via expression. |
| Data Fields | Optional custom data fields to set for the contact, each with a field name and corresponding value. |
Output
JSON
contactId- The unique identifier of the added or updated contact.email- The email address of the contact.smsNumber- The SMS number of the contact.tags- List of tags assigned to the contact.fields- Custom data fields associated with the contact.
Dependencies
- Requires API authentication credentials to connect to the contact management service.
Troubleshooting
- Ensure that either an email address or SMS number is provided; otherwise, the operation may fail due to missing contact identifiers.
- If the specified opt-in process or tag ID does not exist or is invalid, the operation may return an error.
- Network or authentication errors may occur if API credentials are incorrect or expired; verify and update credentials as needed.
Links
- n8n Expressions Documentation - Documentation on how to use expressions in n8n for dynamic input values.