3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node is designed to create a new parameter in the context of the 3CX telephony system via its API. It allows users to define and send custom parameters such as Id, Name, Description, and Value to the 3CX system. This can be useful for automating configuration or integration tasks where parameters need to be programmatically managed within 3CX.

Practical examples include:

  • Automatically adding new configuration parameters during deployment.
  • Updating system settings by creating parameters dynamically.
  • Integrating 3CX with other systems that require parameter synchronization.

Properties

Name Meaning
Description A textual description of the parameter being created.
Id A numeric identifier for the parameter.
Name The name/key of the parameter to create.
Value The value assigned to the parameter.

Output

The node outputs JSON data representing the response from the 3CX API after attempting to create the parameter. This typically includes confirmation details about the newly created parameter or error information if the creation failed.

No binary data output is indicated.

Dependencies

  • Requires an active connection to a 3CX telephony system.
  • Needs an API authentication token (OAuth2) configured in n8n credentials to authorize requests.
  • The base URL for the 3CX API must be provided in the credentials configuration.
  • The node sends HTTP requests with JSON payloads to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Authentication errors: Ensure the OAuth2 API credential is correctly set up with valid tokens and the server URL is accurate.
  • Invalid parameter values: Check that the Id is a number and that Name and Value are non-empty strings as required by the 3CX API.
  • Network issues: Verify connectivity to the 3CX server and that the API endpoint is reachable.
  • API errors: Review the JSON response for error messages returned by 3CX, which may indicate permission issues or invalid request formats.

Links and References

Discussion