NCentral n8n Node

Interact with the N-central API-Service to manage devices, customers, service organizations, scheduled tasks, maintenance windows, PSA integrations, and more.

Installation

In your n8n instance, go to Settings > Community Nodes and install:

@zackrobertstech/n8n-nodes-ncentral

Compatibility

• n8n version: >=1.0.0
• Node.js version: >=18

Credentials

Configure your NCentral API credentials in n8n.

Resources & Operations

Base URL: https://ncod104.n-able.com/api

Access Groups

| Endpoint | Description | |---|---| | 🔵 GET /api/access-groups | List the access group related links. | | 🔵 GET /api/access-groups/{accessGroupId} | Retrieve detailed information for a specific Access Group by ID. | | 🔵 GET /api/org-units/{orgUnitId}/access-groups | Retrieve Access Groups Information for an Org Unit by ID. | | 🟢 POST /api/org-units/{orgUnitId}/access-groups | Creates a new organization unit type access group. | | 🟢 POST /api/org-units/{orgUnitId}/device-access-groups | Creates a new device type access group. |

Active Issues

| Endpoint | Description | |---|---| | 🔵 GET /api/org-units/{orgUnitId}/active-issues | Fetch active issues |

API Service

| Endpoint | Description | |---|---| | 🔵 GET /api | List links to other endpoints. | | 🔵 GET /api/health | Return the start and current time of the server. This indicates that the server is running. | | 🔵 GET /api/server-info | Return version information of the running API-Service. | | 🔵 GET /api/server-info/extra | Get information about the version of different systems in N-central. | | 🟢 POST /api/server-info/extra/authenticated | Get extra information about the version of different systems in N-central using credentials. | | 🔵 GET /api/server-info/time | Returns the server time information. |

Authentication

| Endpoint | Description | |---|---| | 🔵 GET /api/auth | List the authentication-related links. | | 🟢 POST /api/auth/authenticate | Obtains access and refresh tokens using an N-central User-API Token (JWT). | | 🟢 POST /api/auth/logout | Invalidates the current session. | | 🟢 POST /api/auth/refresh | Obtains a new API-Access token using a valid refresh token. | | 🟢 POST /api/auth/sso | Obtains access and refresh tokens using an SSO access token. | | 🔵 GET /api/auth/validate | Check the validity of the API-Access token. |

Custom Properties

| Endpoint | Description | |---|---| | 🔵 GET /api/devices/{deviceId}/custom-properties | Retrieve Device Custom Properties by device id | | 🔵 GET /api/devices/{deviceId}/custom-properties/{propertyId} | Get the device custom property. | | 🟡 PUT /api/devices/{deviceId}/custom-properties/{propertyId} | Modify Device Custom Property | | 🔵 GET /api/org-units/{orgUnitId}/custom-properties | Get the list of organization custom properties. | | 🔵 GET /api/org-units/{orgUnitId}/custom-properties/{propertyId} | Get the organization unit custom property. | | 🟡 PUT /api/org-units/{orgUnitId}/custom-properties/{propertyId} | Update the organization unit custom property. | | 🔵 GET /api/org-units/{orgUnitId}/custom-properties/device-custom-property-defaults/{propertyId} | Retrieve Device Default Custom Property information by organization unit id and property id | | 🟡 PUT /api/org-units/{orgUnitId}/org-custom-property-defaults | Update the default organization unit custom property. | | 🔵 GET /api/org-units/{orgUnitId}/org-custom-property-defaults/{propertyId} | Get the organization unit custom property. |

Device Filters

| Endpoint | Description | |---|---| | 🔵 GET /api/device-filters | Retrieve the list of filters. |

Device Tasks

| Endpoint | Description | |---|---| | 🔵 GET /api/devices/{deviceId}/scheduled-tasks | Retrieve tasks for a specific device. |

Devices

| Endpoint | Description | |---|---| | 🔵 GET /api/appliance-tasks/{taskId} | Retrieves the appliance-task information. | | 🟢 POST /api/device | Add a new device. | | 🔵 GET /api/devices | Retrieve the list of devices. | | 🔵 GET /api/devices/{deviceId} | Retrieve a device by ID. | | 🔴 DELETE /api/devices/{deviceId} | Delete a device by ID. | | 🔵 GET /api/devices/{deviceId}/activation-key | Generate an activation key for a device. | | 🔵 GET /api/devices/{deviceId}/assets | Retrieve Asset Information for a device by ID. | | 🔵 GET /api/devices/{deviceId}/assets/lifecycle-info | Retrieve a device asset lifecycle information by Device ID. | | 🟡 PUT /api/devices/{deviceId}/assets/lifecycle-info | Modifies the Asset Lifecycle Information by Device Id. | | 🟣 PATCH /api/devices/{deviceId}/assets/lifecycle-info | Modifies the Asset Lifecycle Information by Device Id. | | 🔵 GET /api/devices/{deviceId}/notes | List notes for a device | | 🟢 POST /api/devices/{deviceId}/notes | Add a note to a device | | 🔴 DELETE /api/devices/{deviceId}/notes | Delete multiple notes from a device | | 🟡 PUT /api/devices/{deviceId}/notes/{noteId} | Modify a note on a device | | 🔴 DELETE /api/devices/{deviceId}/notes/{noteId} | Delete a note from a device | | 🔵 GET /api/devices/{deviceId}/service-monitor-status | Retrieves the status of the service monitoring tasks for a given device. | | 🟢 POST /api/devices/notes | Add a note to multiple devices | | 🔵 GET /api/org-units/{orgUnitId}/devices | Retrieve the list of devices by org unit id. |

Job Statuses

| Endpoint | Description | |---|---| | 🔵 GET /api/org-units/{orgUnitId}/job-statuses | Fetch job statuses |

Maintenance Windows

| Endpoint | Description | |---|---| | 🔵 GET /api/devices/{deviceId}/maintenance-windows | Retrieves all maintenance windows for a device. | | 🟢 POST /api/devices/maintenance-windows | Adds set of maintenance windows for a list of given devices. | | 🟡 PUT /api/devices/maintenance-windows | Modifies existing device patch maintenance windows by it's given ScheduleId. | | 🔴 DELETE /api/devices/maintenance-windows | Deletes device patch maintenance windows by given list of Schedule Ids. |

Organization Units

| Endpoint | Description | |---|---| | 🔵 GET /api/customers | Retrieve a list of all customers. | | 🔵 GET /api/customers/{customerId} | Retrieve a customer. | | 🔵 GET /api/customers/{customerId}/sites | PREVIEW: Retrieve a list of sites under a customer. | | 🟢 POST /api/customers/{customerId}/sites | PREVIEW: Creates a site. | | 🔵 GET /api/org-units | Retrieve a list of all organization units. | | 🔵 GET /api/org-units/{orgUnitId} | Retrieve an organization unit. | | 🔵 GET /api/org-units/{orgUnitId}/children | Retrieve a list of all organization units children. | | 🔵 GET /api/org-units/{orgUnitId}/limits | Retrieve customer limits. | | 🟣 PATCH /api/org-units/{orgUnitId}/limits | Update customer limits. | | 🔵 GET /api/service-orgs | Retrieve a list of all service organizations. | | 🟢 POST /api/service-orgs | Creates a new service organization (SO). | | 🔵 GET /api/service-orgs/{soId} | Retrieve a service organization. | | 🔵 GET /api/service-orgs/{soId}/customers | Retrieve a list of all customers under a service organization. | | 🟢 POST /api/service-orgs/{soId}/customers | Creates a customer. | | 🔵 GET /api/sites | Retrieve a list of all sites. | | 🔵 GET /api/sites/{siteId} | Retrieve a site. |

Patch Reports

| Endpoint | Description | |---|---| | 🔵 GET /api/report/{reportId} | Retrieves a report by id. | | 🟢 POST /api/report/patch-comparison | Submits a request to generate a patch comparison report. |

PSA

| Endpoint | Description | |---|---| | 🔵 GET /api/custom-psa | List the custom psa related links. | | 🔵 GET /api/custom-psa/tickets | List the custom psa tickets related links. | | 🟢 POST /api/custom-psa/tickets | Create a Custom PSA Ticket in N-central. | | 🔵 GET /api/custom-psa/tickets/{customPsaTicketId} | Retrieve detailed information for a specific Custom PSA Ticket by ID without PSA credentials. | | 🟢 POST /api/custom-psa/tickets/{customPsaTicketId} | Retrieve detailed information for a specific Custom PSA Ticket by ID. | | 🟢 POST /api/custom-psa/tickets/{customPsaTicketId}/reopen | Reopen a Custom PSA Ticket in N-central. | | 🟢 POST /api/custom-psa/tickets/{customPsaTicketId}/resolve | Resolve a Custom PSA Ticket in N-central. | | 🔵 GET /api/standard-psa | List the standard psa related links. | | 🟢 POST /api/standard-psa/{psaType}/credential | Validate Standard PSA Credentials. | | 🔵 GET /api/standard-psa/customer-mapping/{customerId} | Get Customer Mappings for a given customer ID. [Deprecated] | | 🔵 GET /api/standard-psa/customer/{customerId}/mappings | Get Customer Mappings for a given customer ID. | | 🟡 PUT /api/standard-psa/customer/{customerId}/mappings | Update Customer Mappings for a given customer ID. | | 🔵 GET /api/standard-psa/customers/{customerId}/companies | Get PSA Companies for a given customer ID. | | 🔵 GET /api/standard-psa/customers/{customerId}/companies/{psaCompanyId}/contacts | Get PSA Contacts for a given customer ID and PSA company ID. | | 🔵 GET /api/standard-psa/customers/{customerId}/companies/{psaCompanyId}/sites | Get PSA Sites for a given customer ID and PSA company ID. |

Registration Tokens

| Endpoint | Description | |---|---| | 🔵 GET /api/customers/{customerId}/registration-token | PREVIEW: Retrieve a customer registration token. | | 🔵 GET /api/org-units/{orgUnitId}/registration-token | Retrieve a organization unit registration token. | | 🔵 GET /api/sites/{siteId}/registration-token | PREVIEW: Retrieve a site registration token. |

Scheduled Tasks

| Endpoint | Description | |---|---| | 🔵 GET /api/scheduled-tasks | List the task-related links. | | 🔵 GET /api/scheduled-tasks/{taskId} | Retrieves general information for a given task. | | 🔵 GET /api/scheduled-tasks/{taskId}/status | Retrieves aggregated status for a given task. | | 🔵 GET /api/scheduled-tasks/{taskId}/status/details | Retrieves detailed status per device for a given task. | | 🟢 POST /api/scheduled-tasks/direct | Create a direct-support schedule task. |

Software Installers

| Endpoint | Description | |---|---| | 🔵 GET /api/customers/{customerId}/software/installers | Get Software Installers | | 🟢 POST /api/customers/{customerId}/software/installers | Generate Software Download Link |

User Roles

| Endpoint | Description | |---|---| | 🔵 GET /api/org-units/{orgUnitId}/user-roles | PREVIEW: Retrieve a list of user roles for a given organization unit. | | 🟢 POST /api/org-units/{orgUnitId}/user-roles | PREVIEW: Add a new user role for a given organization unit. | | 🔵 GET /api/org-units/{orgUnitId}/user-roles/{userRoleId} | PREVIEW: Retrieve a user role for a given organization unit and user role id. |

Users

| Endpoint | Description | |---|---| | 🔵 GET /api/org-units/{orgUnitId}/users | Retrieve the list of users. | | 🔵 GET /api/users | List the user related links. | | 🔵 GET /api/users/me | Get the current authenticated user's information. |

Resources

• n8n Community Nodes Documentation
• NCentral API Documentation

Built with

This node was generated using Zack Roberts Node Studio, powered by @zackrobertstech/n8n-openapi-node-builder (a maintained fork of @avantguardllc/n8n-openapi-node).

License

MIT