Actions29
- Agent Actions
- Call Actions
- Contact Actions
- Contact Property Actions
- Deprecated Actions
- Phone Number Actions
Contact → Create Contact
AI-generatedOverview
This node operation creates a new contact using the Telli API v2. It requires essential contact details such as first name, last name, and phone number in E.164 format. Optional fields include external ID, external URL, salutation, timezone, email, and custom properties. Custom properties can be specified either as individual key-value pairs or as a JSON array. The node sends a POST request to the Telli API to create the contact and returns the API response.
Use Case Examples
- Creating a new contact in a CRM system with detailed information including custom properties for personalized communication.
- Adding a contact to a marketing platform with external identifiers and timezone information for targeted campaigns.
Properties
| Name | Meaning |
|---|---|
| First Name | Contact first name, required for creating the contact. |
| Last Name | Contact last name, required for creating the contact. |
| Phone Number | Contact phone number in E.164 format, required for creating the contact. |
| External ID | External contact identifier, optional. |
| External URL | Link to contact in external system, optional. |
| Salutation | Formal greeting, optional. |
| Timezone (IANA) | IANA timezone identifier (e.g., Europe/Berlin), optional. |
| Contact email address, optional. | |
| Properties Mode | How to specify custom contact properties, either using fields below or JSON. |
| Properties | Custom contact properties as key/value pairs when Properties Mode is 'fields'. |
| Properties (JSON) | Custom properties as a JSON array of {key, value} objects when Properties Mode is 'json'. |
Output
JSON
json- The JSON response from the Telli API containing the created contact details.
Dependencies
- Telli API authentication credential
Troubleshooting
- Ensure the phone number is in valid E.164 format; otherwise, the node throws an error indicating invalid phone number format.
- Required fields (First Name, Last Name, Phone Number) must be provided; missing these will cause the node to throw an error.
- API errors from the Telli service are caught and reported with status code and message for easier debugging.