Actions31
- Conversation Actions
- Message Actions
- Visitor Actions
- Contact Actions
- Bot Actions
- Operator Actions
Contact → Create Contact
AI-generatedOverview
This node integrates with the Tidio API to manage contacts within a live chat and customer engagement platform. Specifically, the Create Contact operation allows users to add new contact records by providing details such as name, email, phone number, and other optional fields.
Typical use cases include:
- Automatically adding new leads or customers from form submissions or CRM systems.
- Enriching contact data with custom properties or tags for segmentation.
- Triggering chatbot flows or assigning contacts to mailing lists upon creation.
For example, you could create a contact when a visitor fills out a signup form on your website, including their name, email, and phone number, and optionally assign tags or custom properties to personalize future interactions.
Properties
| Name | Meaning |
|---|---|
| Additional Fields | Collection of optional fields to specify contact details and related metadata: |
| - Visitor Name | Name of the visitor (string) |
| - Visitor Email | Email address of the visitor (string) |
| - Visitor Phone | Phone number of the visitor (string) |
| - Tags | Comma-separated list of tags (string) |
| - Tag Name | Name of a tag to add or remove (string) |
| - Custom Properties | JSON object of custom properties to attach to the contact |
| - Contact Name | Full name of the contact (string) |
| - Contact Email | Email address of the contact (string) |
| - Contact Phone | Phone number of the contact (string) |
| - Mailing List ID | ID of the mailing list to add the contact to (string) |
| - Bot Flow ID | ID of the bot flow to trigger for this contact (string) |
| - Status | Operator status; options: Online, Offline, Away |
| - Department | Department name or ID associated with the contact (string) |
| - Priority | Conversation priority; options: Low, Normal, High, Urgent |
| - Limit | Maximum number of results to return (number) — relevant for listing operations |
| - Offset | Number of results to skip (number) — relevant for listing operations |
| - Auto Reply | Enable automatic replies (boolean) |
| - Send As Bot | Send message as bot rather than operator (boolean) |
For the Create Contact operation, the key input fields are contactName, contactEmail, and contactPhone. Other fields can be used to enrich the contact record.
Output
The node outputs an array of JSON objects representing the response from the Tidio API after creating the contact. The structure typically includes the newly created contact's details such as:
- Contact ID
- Name
- Phone
- Any additional properties or tags set during creation
If the operation fails, the output will contain an error message describing the issue.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Tidio API.
- Needs configuration of API URL, client ID, and client secret credentials.
- Uses an external proxy service (
https://n8ntools.io/api/v1/proxy/tidio) to forward requests to the Tidio API. - Must have internet access to communicate with the Tidio API endpoints.
Troubleshooting
Common issues:
- Missing or invalid API credentials will cause authentication failures.
- Providing incomplete required fields (e.g., missing contact email) will result in validation errors.
- Incorrect JSON format in custom properties may cause parsing errors.
- Network connectivity problems can prevent successful API calls.
Error messages:
"Unknown contact operation": Indicates an unsupported operation was selected."Unknown resource": Indicates an invalid resource parameter.- API errors returned from Tidio will be passed through in the output JSON under an
errorfield.
Resolutions:
- Verify that all required credentials are correctly configured.
- Ensure mandatory fields like contact name and email are provided.
- Validate JSON syntax for any custom properties before submitting.
- Check network connectivity and proxy settings if requests fail.