3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node integrates with the 3CX telephony system, allowing users to perform various operations related to communication management. Specifically, the "Delete Company By Id" operation under the "Groups" resource enables users to delete a company record from the 3CX system by specifying its unique identifier. This is useful for automating cleanup tasks, managing organizational structures, or synchronizing external systems with 3CX data.

Practical examples include:

  • Automatically removing companies that are no longer active in your CRM.
  • Cleaning up test or temporary company entries after automated workflows.
  • Integrating with HR or ERP systems to keep telephony groups aligned with current company data.

Properties

Name Meaning
Id The unique numeric identifier of the company to be deleted.

Output

The node outputs JSON data representing the response from the 3CX API after attempting to delete the specified company. Typically, this will include confirmation of deletion or error details if the operation failed.

No binary data output is expected from this operation.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or missing company Id: Ensure the Id provided corresponds to an existing company.
    • Authentication errors: Verify that the API key or OAuth2 token is valid and has sufficient permissions.
    • Network or connectivity problems: Confirm that the 3CX server URL is correct and accessible.

  • Error messages:

    • Unauthorized or 401 errors indicate invalid credentials.
    • 404 Not Found may mean the company Id does not exist.
    • 400 Bad Request could result from malformed input; check the Id value.

Resolving these typically involves verifying input parameters, checking credentials, and ensuring network access.

Links and References

Discussion