ConnectWise Manage icon

ConnectWise Manage

Consume ConnectWise Manage API

Overview

The ConnectWise Manage node for n8n allows you to interact with the ConnectWise Manage API.
For the Time resource and the Create operation, this node enables you to create new time entry records in your ConnectWise Manage system.

Common scenarios:

  • Logging billable or non-billable hours worked by team members.
  • Tracking time spent on specific projects, support tasks, or administrative duties.
  • Associating time entries with companies, charge codes, or work types for reporting and billing purposes.

Practical example:
A service company uses this node to automatically log time entries when a support ticket is resolved, including details such as start/end times, notes, and whether the time is billable.


Properties

Name Type Meaning
Time Start string Start time of the time entry (format: YYYY-MM-DD HH:mm:ss). Required.
Additional Fields collection Optional fields to further describe the time entry. See below for sub-fields.

Additional Fields (collection):

Name Type Meaning
Billable boolean Whether the time entry is billable.
Charge Code string The charge code associated with the time entry.
Company ID string The company linked to this time entry.
Member ID string The member (user) who performed the work.
Notes string Any notes or comments about the time entry.
Time End string End time of the time entry (format: YYYY-MM-DD HH:mm:ss).
Work Type options The type of work performed. Options: Administrative, Project, Support.

Output

  • The output will be a single JSON object representing the newly created time entry.
  • The structure of the output JSON will reflect the fields sent to and returned by the ConnectWise Manage API, typically including:
    • timeEntryId (unique identifier)
    • timeStart
    • timeEnd
    • billable
    • chargeCode
    • company
    • member
    • notes
    • workType
    • ...and other metadata provided by the API.

Example output:

{
  "timeEntryId": 12345,
  "timeStart": "2024-06-01 09:00:00",
  "timeEnd": "2024-06-01 11:00:00",
  "billable": true,
  "chargeCode": "DEV",
  "company": "Acme Corp",
  "member": "jdoe",
  "notes": "Worked on project setup.",
  "workType": "Project"
}

Dependencies

  • External Service: Requires access to a ConnectWise Manage instance with API enabled.
  • API Credentials: You must configure n8n credentials for connectWiseManageApi, including at least:
    • Site URL
    • Public/Private API keys
  • n8n Configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common issues:

  • Missing Required Field: If "Time Start" is not provided, the node will throw an error indicating a required field is missing.
  • Invalid Date Format: If date/time fields are not in the expected format (YYYY-MM-DD HH:mm:ss), the API may reject the request.
  • Authentication Errors: Invalid or missing API credentials will result in authentication failures.
  • Permission Denied: The API user may lack permission to create time entries.

Error messages and resolutions:

  • "Operation 'create' is not supported": Ensure you selected the correct resource and operation.
  • "Resource 'time' is not supported": Double-check that you have chosen the correct resource.
  • "Unknown error occurred during item execution": Review input data and ensure all required fields are present and correctly formatted.
  • API Error Responses: The node logs detailed error responses from ConnectWise; check the n8n execution logs for more information.

Links and References

Discussion