Actions102
- Activity Actions
- Agreement Actions
- Company Actions
- Configuration Actions
- Contact Actions
- Document Actions
- Expense Actions
- Invoice Actions
- Member Actions
- Opportunity Actions
- Product Catalog Actions
- Project Actions
- Purchase Order Actions
- Schedule Actions
- Service Ticket Actions
- Time Actions
Overview
This node integrates with the ConnectWise Manage API to perform operations on various resources within a ConnectWise Manage instance. Specifically, for the Agreement resource with the Get operation, it retrieves detailed information about a single agreement by its unique ID.
Common scenarios where this node is beneficial include:
- Fetching contract or agreement details to automate billing, reporting, or compliance workflows.
- Integrating agreement data into other systems such as CRM, ERP, or document management platforms.
- Validating agreement status or terms before proceeding with related business processes.
Example:
You have an automation that triggers when a new support ticket is created and you want to enrich the ticket data with the associated customer agreement details. Using this node, you can fetch the agreement by its ID and use the returned data downstream in your workflow.
Properties
| Name | Meaning |
|---|---|
| Agreement ID | The unique identifier of the agreement to retrieve. This is a required string input. |
Output
The node outputs JSON data representing the full details of the requested agreement as returned by the ConnectWise Manage API. The structure typically includes fields such as agreement name, ID, status, start and end dates, billing terms, and other metadata defined in ConnectWise Manage.
If the operation succeeds, the output will be a single JSON object with the agreement's properties.
The node does not output binary data for this operation.
Dependencies
- Requires an active connection to a ConnectWise Manage instance via an API key credential configured in n8n.
- The node uses the ConnectWise Manage REST API v3.0 endpoints.
- The user must provide the base site URL and valid authentication credentials for the API.
Troubleshooting
Missing or invalid Agreement ID:
If the Agreement ID is not provided or incorrect, the node will throw an error indicating the resource could not be found. Ensure the Agreement ID is correct and exists in ConnectWise Manage.Authentication errors:
If the API credentials are invalid or expired, the node will fail with an authentication error. Verify the API key and permissions.Unsupported operation or resource:
The node explicitly checks if the operation and resource are supported. Using unsupported combinations will result in clear error messages.API request failures:
Network issues or API downtime may cause request failures. The node logs detailed error responses from ConnectWise Manage to assist debugging.Continue on Fail behavior:
If enabled, the node will output error details per item instead of stopping execution, useful for batch processing.
Links and References
- ConnectWise Manage API Documentation
- n8n Documentation - HTTP Request Node (for understanding API calls)
- ConnectWise Manage Agreements API Reference