Skip to content

redanthrax/halopsa-node

Repository files navigation

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

Setup

Setting up OAuth 2.0 in HaloPSA

  1. Log into your HaloPSA instance
  2. Navigate to Configuration > Integrations > HaloPSA API
  3. Create a new OAuth 2.0 Client Application
  4. Set the Grant Type to "Client Credentials"
  5. Configure the appropriate scopes (recommend "all" for full access)
  6. Note down the Client ID and Client Secret for use in n8n

Configuring Credentials in n8n

  1. Base API URL: Your HaloPSA instance URL (e.g., https://your-domain.halopsa.com)
  2. Client ID: OAuth 2.0 Client ID from HaloPSA
  3. Client Secret: OAuth 2.0 Client Secret from HaloPSA
  4. 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

Manage agent records with extensive filtering options for departments, teams, roles, and permissions.

Complete asset management with CRUD operations, comprehensive filtering, and integration support across multiple platforms.

Manage client records including creation, updates, and retrieval with enhanced custom fields support.

Manage custom field definitions and metadata with CRUD operations and enhanced multi-select integration across resources.

Comprehensive invoice management with CRUD operations, line item updates, and voiding capabilities.

Complete site management with full CRUD operations, extensive configuration options, and comprehensive client integration.

Manage ticket status configurations and workflows.

Configure and manage ticket type definitions.

Complete CRUD operations for HaloPSA tickets with comprehensive filtering options.

Comprehensive user management with full CRUD operations, extensive filtering options, and advanced configuration including security roles, site associations, and custom field support.

Track work hours with timesheet management including creation, updates, and time tracking.

Manage individual timesheet events and time entries within timesheets.

Manage webhooks and automation runbooks with full CRUD operations and comprehensive configuration options.

Manage webhook events that define the types of activities that can trigger webhook notifications.

Resources

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published