Actions19
Overview
This node integrates with the Syncro RMM API to create a new Asset record associated with a customer. It is useful in IT management workflows where you need to programmatically add assets such as computers, devices, or other equipment into the Syncro system for tracking and management purposes.
Typical use cases include:
- Automatically registering new hardware purchases into the asset inventory.
- Adding assets during onboarding of new customers.
- Synchronizing asset data from external systems into Syncro RMM.
For example, after a purchase order is approved, this node can create an asset entry linked to the customer with details like asset type, serial number, and custom metadata fields.
Properties
| Name | Meaning |
|---|---|
| Customer ID | Numeric identifier of the customer to whom the asset belongs. |
| Asset Type Name or ID | Select the type of asset from a predefined list or specify an ID directly. This defines the category/classification of the asset (e.g., laptop). |
| Asset Name | The name or label for the asset, e.g., "Office Laptop #12". |
| Serial Number | The serial number of the asset, useful for unique identification and warranty tracking. |
| Custom Fields | A collection of key-value pairs to set additional custom metadata on the asset. Each custom field is selected from those available for the asset type, and a value is assigned. |
Output
The node outputs JSON data representing the newly created asset object as returned by the Syncro RMM API. This typically includes:
- The asset's unique ID.
- Associated customer ID.
- Asset type details.
- Name and serial number.
- Any custom fields set.
- Metadata such as creation timestamps.
If the API supports it, binary data output is not applicable here since this operation deals with structured JSON asset records only.
Dependencies
- Requires an active Syncro RMM account with API access enabled.
- Needs an API key credential configured in n8n for authentication.
- The node uses the Syncro RMM REST API endpoint specific to the user's subdomain.
- Network connectivity to the Syncro RMM service.
Troubleshooting
- Invalid API Key: If the API key is incorrect or expired, the node will fail authentication. Verify the API key and update credentials in n8n.
- Missing Required Fields: Ensure that mandatory properties like Customer ID and Asset Type are provided; otherwise, the API may reject the request.
- Custom Field Errors: When setting custom fields, ensure the field IDs correspond to the selected asset type and values are valid.
- Network Issues: Connectivity problems to the Syncro RMM API endpoint will cause failures; check firewall and internet access.
- Permission Denied: The API key must have permissions to create assets; insufficient privileges will result in errors.
Links and References
- Syncro RMM API Documentation — Official API reference for asset creation and related operations.
- n8n Expressions Documentation — Guide on using expressions to dynamically set property values.