Description
n8n-nodes-halopsacomplete
An n8n community node for integrating with HaloPSA API.
Installation
Follow the installation guide in the n8n community nodes documentation.
npm install n8n-nodes-halopsacomplete
Prerequisites
- HaloPSA instance with API access
- OAuth 2.0 Client ID and Client Secret from HaloPSA
- Your HaloPSA base URL (e.g., https://your-domain.halopsa.com)
Setup
Setting up OAuth 2.0 in HaloPSA
- Log into your HaloPSA instance
- Navigate to Configuration > Integrations > HaloPSA API
- Create a new OAuth 2.0 Client Application
- Set the Grant Type to "Client Credentials"
- Configure the appropriate scopes (recommend "all" for full access)
- Note down the Client ID and Client Secret for use in n8n
Configuring Credentials in n8n
- Base API URL: Your HaloPSA instance URL (e.g., https://your-domain.halopsa.com)
- Client ID: OAuth 2.0 Client ID from HaloPSA
- Client Secret: OAuth 2.0 Client Secret from HaloPSA
- Scope: OAuth 2.0 scope (default: "all" for full API access)
Supported Operations
Triggers
HaloPSA Trigger
Receive real-time webhook notifications from HaloPSA for ticket events:
- New Ticket Logged – Triggered when a new ticket is created
- Ticket Updated by User – Triggered when a user updates a ticket
- Closed – Triggered when a ticket is closed
- 1st SLA Warning – Triggered on first SLA breach warning
- 2nd SLA Warning – Triggered on second SLA breach warning
- Ticket Deadline – Triggered when a ticket reaches its deadline
- Ticket Status Changed – Triggered when ticket status changes
- Ticket Deleted – Triggered when a ticket is deleted
The trigger automatically creates and manages webhooks in HaloPSA, handling subscription and cleanup.
Actions
Agents
Manage agent records with extensive filtering options for departments, teams, roles, and permissions.
Assets
Complete asset management with CRUD operations, comprehensive filtering, and integration support across multiple platforms.
Clients
Manage client records including creation, updates, and retrieval with enhanced custom fields support.
Field Info
Manage custom field definitions and metadata with CRUD operations and enhanced multi-select integration across resources.
Invoices
Comprehensive invoice management with CRUD operations, line item updates, and voiding capabilities.
Sites
Complete site management with full CRUD operations, extensive configuration options, and comprehensive client integration.
Ticket Statuses
Manage ticket status configurations and workflows.
Ticket Types
Configure and manage ticket type definitions.
Tickets
Complete CRUD operations for HaloPSA tickets with comprehensive filtering options.
Users
Comprehensive user management with full CRUD operations, extensive filtering options, and advanced configuration including security roles, site associations, and custom field support.
Timesheet
Track work hours with timesheet management including creation, updates, and time tracking.
Timesheet Events
Manage individual timesheet events and time entries within timesheets.
Webhooks
Manage webhooks and automation runbooks with full CRUD operations and comprehensive configuration options.
Webhook Events
Manage webhook events that define the types of activities that can trigger webhook notifications.
Resources
License
MIT
