Creating workflows for NinjaRMM devices

Let Oomnitza be your single source of truth!

You'll get complete visibility of your assets, software, and users as data from NinjaRMM is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and NinjaRMM in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key information
• Configurable reports to share information with your colleagues and management
• Configurable asset workflows that you can easily create to automate tasks such as:
  • Workflows for approving and rejecting devices
  • Workflows for rebooting devices
  • Workflows for getting and updating custom device fields
  • Workflows for scheduling and canceling maintenance operations

Let Oomnitza be your single source of truth!

You'll get visibility of your devices as data from NinjaRMM is automatically transformed into consumable information and actionable insights.

Before you start

Creating workflows

Create asset workflows

Approve or Reject Device

Cancel Device Maintenance

Get Custom Device Fields

Reboot Device

Schedule Device Maintenance

Update Custom Device Field

Before you start

Before you create workflows, you need to have added your NinjaRMM credentials to Oomnitza.

We recommend that you also create the extended integration for NinjaRMM assets. You can use the information retrieved in these integrations to trigger workflows that can cancel devices, reboot devices, and much more.

Creating workflows

Create asset workflows

To create an asset workflow, you must select the credentials that you created in Adding your NinjaRMM credentials to Oomnitza.

To choose a preset, complete these steps:  

1. Click Configuration > Workflows 
2. Click Add (+) and select Assets from the list.
3. Drag and drop the API block onto the Sandbox.
4. Click Edit on the API block and enter NinjaRMM in the search field. 
5. Select a preset:
   • NinjaRMM Approve or Reject Device
   • NinjaRMM Cancel Device Maintenance
   • NinjaRMM Get Custom Device Fields
   • NinjaRMM Reboot Device
   • NinjaRMM Schedule Device Maintenance
   • NinjaRMM Update Custom Device Field
   • To choose a preset, click the forward arrow (>).
6. Configure the API Block following the preset instructions below, and save your changes.
7. Edit the Begin Block and add rules to trigger the workflow. For example, if you set the Actions to New you can trigger a workflow every time a new asset is created. Refer to Using the Begin block.
8. Connect the Blocks. 
9. Save, validate, and activate your workflow.

Using the Approve or Reject Device preset

The Approve or Reject Device preset enables you to approve or reject devices that are waiting for approval. 

When you select this preset you need to enter either APPROVE or REJECT in the Approval Value field.

You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Body tab. You will notice that the NinjaRMM Device ID is referenced in the property {{ninjarmm_device_id}}. You can map the Device ID to this field by creating an asset integration and following the mapping steps in Creating custom mappings, otherwise you can enter the Device ID instead.
3. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza.

For further information, refer to NinjaOne Public API: Approve/Reject devices.

Using the Cancel Device Maintenance preset

The Cancel Device Maintenance preset enables you to cancel pending or active maintenance for a device.

You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Information tab. You will notice that the NinjaRMM Device ID is referenced in the property {{ninjarmm_device_id}}. Map the Device ID to this field by creating an asset integration and following the mapping steps in Creating custom mappings, otherwise, enter the Device ID.
3. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza.

For further information, refer to NinjaOne Public API: Cancel maintenance.

Using the Get Custom Device Fields preset

The Get Custom Device Fields preset returns list of all custom fields by device.

You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Information tab. You will notice that the NinjaRMM Device ID is referenced in the property {{ninjarmm_device_id}}. Map the Device ID to this field by creating an asset integration and following the mapping steps in Creating custom mappings, otherwise, enter the Device ID. Alternatively, you can modify the URL to ...device/custom-fields, which should return a list of all custom fields.
3. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza.

For further information, refer to NinjaOne Public API: Device Custom Fields.

Using the Reboot Device preset

The Reboot Device preset sends a command to restart the computer.

When you select this preset you need to enter either NORMAL or FORCED in the Reboot Mode field.

You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Information tab. You will notice that the NinjaRMM Device ID is referenced in the property {{ninjarmm_device_id}}. Map the Device ID to this field by creating an asset integration and following the mapping steps in Creating custom mappings, otherwise, enter the Device ID. 
3. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza.

For further information, refer to NinjaOne Public API: Reboot Devices.

Using the Schedule Device Maintenance preset

The Schedule Device Maintenance preset sets a scheduled maintenance window for a device. When you select this preset you need to define the start and end time of the maintenance.

You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Information tab. You will notice that the NinjaRMM Device ID is referenced in the property {{ninjarmm_device_id}}. Map the Device ID to this field by creating an asset integration and following the mapping steps in Creating custom mappings, otherwise, enter the Device ID. 
3. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza.

For further information, refer to NinjaOne Public API: Update Device Maintenance.

Using the Update Custom Device Field preset

The Update Custom Device Field preset updates device custom field values.

You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Information tab. You will notice that the NinjaRMM Device ID is referenced in the property {{ninjarmm_device_id}}. Map the Device ID to this field by creating an asset integration and following the mapping steps in Creating custom mappings, otherwise, enter the Device ID. 
3. Select the Body tab. The request body should contain the name of the custom device fields that are to be updated. For further information, refer to NinjaOne Public API: Update Field Values.
4. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza.

Reference articles for workflows

• Mapping positive and negative responses
• Troubleshooting workflows 
• Using the API block