Actions68
- Client Actions
- Agent Actions
- Asset Actions
- Field Info Actions
- Invoice Actions
- Site Actions
- Ticket Actions
- Ticket Status Actions
- Ticket Type Actions
- Timesheet Actions
- Timesheet Event Actions
- Webhook Actions
- Webhook Event Actions
Overview
This node integrates with the HaloPSA API to update details of a specific "Site" resource. It allows users to modify various attributes of a site, such as contact emails, location coordinates, status flags, and other metadata related to the site.
Common scenarios where this node is beneficial include:
- Automating updates to site information in response to changes in your internal systems.
- Synchronizing site data between HaloPSA and other platforms.
- Managing site-specific configurations like default delivery settings or contact details programmatically.
For example, you could use this node to update the email addresses associated with a site or change its timezone and color coding based on business rules or external triggers.
Properties
| Name | Meaning |
|---|---|
| Site ID | The unique identifier (number) of the site to update. |
| Update Fields | A collection of fields to update for the site. Each field is optional and can be set as needed: |
| - Accounts BCC Email Address | BCC email address used for accounts communications. |
| - Accounts CC Email Address | CC email address used for accounts communications. |
| - Accounts Email Address | Primary email address for accounts. |
| - Accounts First Name | First name of the accounts contact person. |
| - Accounts ID | System ID for accounts. |
| - Accounts Last Name | Last name of the accounts contact person. |
| - Client ID | Numeric ID of the client that owns this site. |
| - Colour | Color code assigned to the site (color picker). |
| - Default Delivery | Boolean flag indicating if this is the default delivery site. |
| - Default Stock Location | Numeric ID of the default stock location. |
| - Deliver By | User ID representing the delivery contact. |
| - Disclaimer Match String | String used to match disclaimers. |
| - Email Domain | Email domain associated with the site. |
| - Email Subject Prefix | Prefix added to email subjects sent from this site. |
| - Facilities Manager | User ID of the facilities manager responsible for the site. |
| - Geocoord 1 | First geographic coordinate (latitude or longitude). |
| - Geocoord 2 | Second geographic coordinate (latitude or longitude). |
| - In Use By | User ID of the person currently using the site. |
| - Inactive | Boolean flag indicating whether the site is inactive. |
| - Invoice Address Is Delivery | Boolean indicating if invoice address is the same as delivery address. |
| - Is Invoice Site | Boolean indicating if this site is an invoice site. |
| - Is Stock Location | Boolean indicating if this site is a stock location. |
| - LDAP String | LDAP connection string for the site. |
| - Message Group ID | Numeric ID of the message group for notifications. |
| - Name | Name of the site. |
| - Notes | Additional notes about the site (multi-line text). |
| - Phone Number | Phone number associated with the site. |
| - Phone Number Int | Integer representation of the phone number. |
| - Reference Number | Reference number for the site. |
| - Regional Director | User ID of the regional director responsible for the site. |
| - Seriousness Level | Numeric level indicating seriousness for incidents at the site. |
| - Site Date Format | Numeric code representing preferred date format for the site. |
| - Site Time Offset | Time offset in hours for the site timezone. |
| - SLA ID | Service Level Agreement ID associated with the site. |
| - Stopped | Numeric flag indicating if the site is stopped (0 = active, 1 = stopped). |
| - Timezone | Timezone string for the site (e.g., "America/New_York"). |
| - To Domain | Domain to redirect to for the site. |
Output
The node outputs JSON data representing the updated site object as returned by the HaloPSA API after the update operation. This typically includes all the site's properties reflecting the new values.
If the API supports binary data output for this operation, it is not indicated in the provided source or property definitions, so the output is expected to be purely JSON.
Dependencies
- Requires an API key credential for authenticating with the HaloPSA API.
- The node depends on the HaloPSA API being accessible and properly configured.
- No additional external services are required beyond the HaloPSA API.
- Proper configuration of the API credentials within n8n is necessary.
Troubleshooting
- Invalid Site ID: If the provided Site ID does not exist, the API will likely return an error. Verify the Site ID before running the node.
- Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to update site data.
- Field Validation Errors: Some fields may have constraints (e.g., numeric IDs must be positive integers, email fields must be valid emails). Invalid inputs may cause the API to reject the request.
- Network Issues: Connectivity problems with the HaloPSA API endpoint will cause failures; check network access and API availability.
- Partial Updates: Only fields included in the "Update Fields" collection are changed; omitting required fields might lead to incomplete updates.
Links and References
- HaloPSA API Documentation (Assumed URL, replace with actual if known)
- n8n Documentation on Creating Custom Nodes
- Color Input Type in n8n
This summary is based solely on static analysis of the provided source code and property definitions.