ConnectWise Manage icon

ConnectWise Manage

Consume ConnectWise Manage API
Join our community

Actions102

Overview

The node integrates with the ConnectWise Manage API, specifically enabling operations on various resources such as companies, tickets, contacts, and more. For the Company resource with the Get Many operation, it retrieves multiple company records from ConnectWise Manage.

This operation is useful when you want to fetch a list of companies for reporting, synchronization, or further processing within an n8n workflow. For example, you might use this node to:

  • Retrieve all companies to sync with a CRM system.
  • Fetch a paginated list of companies filtered or ordered by specific fields.
  • Get a limited number of companies for batch processing or analysis.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return (used if "Return All" is false).
Page Number The page number to retrieve (starts at 1).
Page Size Number of results to return per page (minimum 1, maximum 1000).
Order By Field to order results by, e.g., "id" or "ID desc" to specify ascending/descending order.

Note: The property "Order By" appears twice in the provided properties JSON but effectively serves the same purpose — specifying the field and direction to sort the results.

Output

The output consists of one or more items, each containing a json object representing a company record retrieved from ConnectWise Manage. Each item corresponds to a single company entity with its associated fields as returned by the API.

The structure of each json output item matches the company data model from ConnectWise Manage's API, typically including fields like company ID, name, address, contact details, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential configured in n8n for authenticating with the ConnectWise Manage API.
  • The node makes HTTP requests to the ConnectWise Manage REST API endpoint specified in the credentials.
  • Proper permissions on the ConnectWise Manage account are necessary to read company data.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Requesting pages beyond available data may return empty results.
    • Using unsupported or misspelled fields in "Order By" or "Conditions" parameters can lead to API errors.
    • Exceeding the maximum allowed page size (1000) will result in validation errors.

  • Error Messages:

    • "Operation 'getAll' is not supported": Indicates the operation is not recognized for the selected resource; verify resource and operation names.
    • "Resource 'company' is not supported": The resource name might be incorrect or not implemented.
    • API request failures will include error messages from ConnectWise Manage, often indicating invalid parameters or permission issues.
    • Network or connectivity errors will surface as request failures; ensure network access to the API endpoint.

  • Resolution Tips:

    • Double-check API credentials and permissions.
    • Validate input parameters, especially pagination and ordering fields.
    • Use "Return All" carefully to avoid large data loads that may impact performance.
    • Review API documentation for valid query parameters and limits.

Links and References

Discussion