3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node allows you to create a new contact in the 3CX telephony system. It is useful for automating the addition of contacts into your 3CX phonebook or CRM integration workflows. For example, you can use this node to add new customer or employee contact details automatically when they sign up on your website or are added to another system.

Properties

Name Meaning
Business The business name associated with the contact.
Business 2 A secondary business name or additional business information.
Business Fax The fax number for the business.
Company Name The company name related to the contact.
Contact Type The type/category of the contact (e.g., client, supplier).
Department The department within the company the contact belongs to.
Email The email address of the contact.
First Name The first name of the contact person.
Home The home phone number of the contact.
Id Numeric identifier for the contact (usually assigned by the system or user).
Last Name The last name of the contact person.
Mobile 2 A secondary mobile phone number for the contact.
Other Any other phone number or contact detail.
Pager The pager number of the contact.
Phone Number The primary phone number of the contact.
Tag A tag or label to categorize the contact.
Title The job title or position of the contact person.

Output

The node outputs JSON data representing the newly created contact as returned by the 3CX API. This typically includes all the fields sent during creation along with any additional metadata such as unique IDs assigned by the system. There is no binary output.

Dependencies

  • Requires an API authentication token credential for 3CX OAuth2.
  • Needs the base URL of the 3CX server configured in the credentials.
  • The node sends requests to the 3CX REST API endpoint /xapi/v1.

Troubleshooting

  • Authentication errors: Ensure that the API key or OAuth2 token is valid and has not expired.
  • Invalid input data: Check that required fields like FirstName and LastName are provided and correctly formatted.
  • Server URL issues: Verify the 3CX server URL is correct and accessible from where n8n runs.
  • API limits or permissions: Confirm the API user has permission to create contacts and that rate limits are not exceeded.

Links and References

Discussion