Actions19
- Agent Actions
- Campaign Actions
- Contact Actions
- Custom Field Actions
- Label Actions
- WhatsApp Actions
Overview
This node integrates with the Wasapi API to create a new contact in the Wasapi system. It is useful for automating the addition of contacts into your Wasapi-managed communication platform, enabling seamless synchronization of contact data from various sources or workflows.
Typical use cases include:
- Automatically adding new leads captured from web forms or CRM systems.
- Syncing customer information from other databases or applications.
- Enriching contact lists with custom fields and labels for targeted messaging.
For example, you could use this node to add a new contact with their first name, last name, email, phone number, notes, and assign them specific labels and custom fields that categorize or provide additional context about the contact.
Properties
| Name | Meaning |
|---|---|
| First Name | The first name of the contact (required). |
| Last Name | The last name of the contact. |
| Email Address | The email address of the contact. |
| Phone Number | The phone number of the contact (required). |
| Notes | Additional notes related to the contact. |
| Labels Names or IDs | Select one or multiple labels from a list or specify label IDs via expressions to categorize the contact. |
| Custom Fields | Assign multiple custom fields to the contact. Each custom field requires selecting a field name or ID and providing its value. |
Output
The node outputs JSON data representing the newly created contact as returned by the Wasapi API. This typically includes all the contact details such as assigned IDs, names, emails, phone numbers, notes, labels, and any custom fields set during creation.
If the node supports binary data output (not indicated here), it would represent attachments or media related to the contact, but this operation focuses on JSON contact data only.
Dependencies
- Requires an active connection to the Wasapi API using an API key credential configured in n8n.
- The node depends on helper methods to load options dynamically for labels and custom fields, which require proper API access permissions.
- Network connectivity to
https://api-ws.wasapi.io/api/v1is necessary.
Troubleshooting
- Missing required fields: Ensure that "First Name" and "Phone Number" are provided; otherwise, the API will reject the request.
- Invalid label or custom field IDs: When specifying labels or custom fields by ID, verify they exist in your Wasapi account to avoid errors.
- Authentication errors: Confirm that the API key credential is valid and has sufficient permissions.
- API rate limits or downtime: If requests fail repeatedly, check Wasapi service status and consider implementing retry logic.
- Error messages typically indicate missing parameters, invalid values, or authentication issues. Review the error details and adjust input accordingly.
Links and References
- Wasapi Official API Documentation (for detailed API capabilities and field definitions)
- n8n Expressions Documentation (for using expressions in property inputs like labels and custom fields)