MaintainX Integration Setup

Create a streamlined connection between Front Line Workers and your Maintenance Team by automatically creating work orders and updating meters in MaintainX through MachineMetrics Workflows. If you'd like to learn more about this integration's capabilities, take a look here or watch the video below!

Topics Covered

• Integration Features
• Initial Configuration
• Map Assets: MachineMetrics and MaintainX
• Create Work Requests/Orders in MaintainX
• Update your MaintainX Meters

⚠️ Note: This integration requires the Premium tier of MaintainX for work orders and the Enterprise tier for metering.

Integration Features

• Create MaintainX Work Requests from MachineMetrics alarms, downtimes, or manually triggered workflows.

• Automatically update MaintainX meters using MachineMetrics in-cycle time and number of cycles data.

Initial Configuration

To start setting up your MaintainX integration, navigate to the Integration Portal. Once there, select the MaintainX integration and click Authorize.

Before the integration can function, it needs three credentials:

1. MachineMetrics API Key

   • Go to the [API Keys page].

   • Click Create API Key at the bottom right.

   • Check the reporting scope box.

   • Copy the API key and paste it into Enter MachineMetrics API Key.

2. MaintainX JWT

   • Navigate to the Integrations page in MaintainX.

   • Click New Key.

   • Name and generate the key.

   • Copy the JWT and paste it into Enter MaintainX JWT.

3. Secret Key (Password)

   • Create your own secret.

   • Record it for later use when configuring workflows.

Map Assets: MachineMetrics and MaintainX

This integration relies on a custom MaintainX field to determine which MachineMetrics asset matches its MaintainX equivalent.

If MaintainX hasn’t added this field (“MMid”) yet, the integration can create it automatically.

1. Create a workflow in MachineMetrics with any trigger (Operator or Scheduled recommended).

2. Add a Webhook action with these settings:

   • URL: https://maintainx.svc.machinemetrics.com/setup

   • Secret: (Use the same secret from your integration authorization)

3. Trigger the workflow manually.

4. Once completed, refresh MaintainX and confirm the MMid field appears under your assets.

Create Work Requests/Orders in MaintainX

1. Go to Workflows under Automations in MachineMetrics.

2. Click New Workflow.

3. Name your workflow and set a trigger type (Downtime, Alarm, or Manual).

4. Select Webhook as the Action.

5. If you want immediate triggering, set Delay = 0.

6. In Enter URL, add:

   • Work Request → https://maintainx.svc.machinemetrics.com/WorkRequest

   • Work Order → https://maintainx.svc.machinemetrics.com/WorkOrder

7. In Enter Secret, click Create New and enter your secret.

8. Click Save Changes.

When triggered, this workflow automatically creates a corresponding work request or order in MaintainX.

Update Your MaintainX Meters

Before using this feature, ensure your MaintainX meters use Hours and Cycles as measurements.

1. Open Workflows → New Workflow.

2. Name and configure your trigger (Scheduled is recommended).

3. Set the Action to Webhook.

4. Set Delay = 0 for immediate triggering.

5. In Enter URL, use:
   https://maintainx.svc.machinemetrics.com/Meter

6. Enter your secret.

7. Save the workflow.

When this workflow runs, all time-in-cycle and cycle meters for each machine are updated in MaintainX.

Related Resources

• Integrations Page (Settings)

• Creating and Managing Workflows and Basic Notifications

• Getting Started with MachineMetrics POST APIs using PowerBI

• Operator Dashboard - Custom Tabs