ConnectWise Manage icon

ConnectWise Manage

Consume ConnectWise Manage API

Actions102

Overview

The "Get Many" operation for the "Project" resource in this node retrieves multiple project records from the ConnectWise Manage API. It supports pagination, ordering, and limiting the number of results returned. This operation is useful when you want to fetch a list of projects for reporting, synchronization, or bulk processing purposes.

Typical use cases include:

  • Fetching all projects or a subset based on specific criteria.
  • Retrieving projects ordered by a particular field such as ID or name.
  • Paginating through large sets of projects to process them in batches.

For example, you might use this operation to get the first 100 projects ordered by their creation date or to retrieve all projects without limit for a full data export.

Properties

Name Meaning
Return All Whether to return all available projects or only up to a specified limit.
Limit Maximum number of projects to return (used if "Return All" is false).
Page Number The page number to retrieve, starting at 1 (used for paginated requests).
Page Size Number of projects to return per page (max 1000).
Order By Field to order the results by, e.g., "id", "name", or "ID desc" for descending order.

Output

The output is an array of JSON objects, each representing a project retrieved from ConnectWise Manage. Each object contains the project's fields as returned by the API, such as project ID, name, description, status, and other metadata.

No binary data is output by this operation.

Example output structure (simplified):

[
  {
    "projectId": 123,
    "name": "Project Alpha",
    "status": "Active",
    "description": "Description of Project Alpha",
    ...
  },
  {
    "projectId": 124,
    "name": "Project Beta",
    "status": "Completed",
    "description": "Description of Project Beta",
    ...
  }
]

Dependencies

  • Requires an API key credential for ConnectWise Manage with appropriate permissions to read project data.
  • The node uses the ConnectWise Manage REST API v4_6_release.
  • The base URL for the API must be configured in the credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Requesting pages beyond the available range may return empty results.
    • Using invalid field names in "Order By" can result in API errors.
    • Exceeding the maximum allowed page size (1000) will cause validation errors.

  • Error messages:

    • "Operation 'getAll' is not supported": Indicates the operation name is incorrect or unsupported for the resource.
    • "Resource 'project' is not supported": The resource name is invalid or not implemented.
    • API request failures often include error details from ConnectWise Manage; check the error message for specifics.

  • Resolutions:

    • Verify API credentials and permissions.
    • Use valid field names for ordering.
    • Adjust pagination parameters within allowed limits.
    • Enable "Return All" carefully to avoid very large data loads that may time out.

Links and References

Discussion