Skip to main content

MaintainX

With MaintainX modules in Make, you can watch, create, update, search, retrieve, and delete:

  • watch work order category

  • create a new message

  • list and retrieve locations

  • list and retrieve users

  • watch, search, create, update, and retrieve work orders

  • create a work request

To get started with MaintainX, create an account at getmaintainx.com

Connect MaintainX to Make

To connect MaintainX app, you need to obtain the API Key.

  1. Log in to your MaintainX account.

  2. Click Settings > Integrations > New Key.

    maintainx-1.png
  3. Click Generate Key and copy the API Key to a safe place.

    maintainx-2.png
  4. Log in to your Make account, insert a MaintainX scenario, and click the Add button next to the Connection field.

    maintainx-3.gif
  5. In the Connection name field, enter a name for the connection.

  6. In the API Key field, enter the details copied in step 3 and click Save.

You have successfully connected the MaintainX app and can now build scenarios.

Categories

You can watch the work order categories by using the following module.

Triggers when a new work order category has been chosen.

Connection

Establish a connection to your MaintainX account.

Category

Select or map the categories whose work order you want to update.

Limit

Set the maximum number of work order categories Make will return during one execution cycle. The default value is 10.

Conversions

You can create new messages by using the following module.

Creates a new message.

Connection

Establish a connection to your MaintainX account.

Conversation ID

Select or map the Conversation ID whose message you want to create.

Content

Enter the message to post.

Locations

You can list and retrieve locations by using the following modules.

Retrieves a list of locations.

Connection

Establish a connection to your MaintainX account.

Limit

Set the maximum number of locations Make will return during one execution cycle. The default value is 10.

Retrieves a location.

Connection

Establish a connection to your MaintainX account.

Location ID

Select or map the Location ID whose details you want to retrieve.

Users

You can list, and retrieve users by using the following modules.

Retrieves a list of users

Connection

Establish a connection to your MaintainX account.

Only Assignable

Select whether to show only the users who can be assigned to the work order.

Limit

Set the maximum number of users Make will return during one execution cycle. The default value is 10.

Retrieves a user.

Connection

Establish a connection to your MaintainX account.

User ID

Select or map the User ID whose details you want to retrieve.

Work Orders

You can watch, search, create, update, and retrieve work orders by using the following module.

Triggers when a new work order has been created.

Connection

Establish a connection to your MaintainX account.

Limit

Set the maximum number of work orders Make will return during one execution cycle. The default value is 10.

Searches for work orders.

Connection

Establish a connection to your MaintainX account.

Limit

Set the maximum number of work orders Make will return during one execution cycle. The default value is 10.

See MaintainX Work Orders API reference for entering the field values to search the work orders that match the specified value.

Creates a work order comment.

Connection

Establish a connection to your MaintainX account.

Work Order ID

Select or map the Work Order ID whose comment you want to create.

Content

Enter the comment to be posted.

Updates a work order.

Connection

Establish a connection to your MaintainX account.

Work Order ID

Select or map the Work Order ID whose details you want to update.

For field descriptions, see the MaintainX Work Orders API reference.

Updates a work order status.

Connection

Establish a connection to your MaintainX account.

Work Order ID

Select or map the Work Order ID whose status you want to update.

Status

Select the status of the work order. For example, open.

Retrieves a work order.

Connection

Establish a connection to your MaintainX account.

Work Order ID

Select or map the Work Order ID whose status you want to retrieve.

Work Requests

You can create work requests by using the following module.

Other

You can call APIs using the following module.

Performs an arbitrary authorized API call.

Note

For the list of available endpoints, refer to the MaintainX API documentation.

Connection

Establish a connection to your MaintainX account.

URL

Enter a path relative to https://api.getmaintainx.com. For example, /v1/assets.

Method

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of use - List Workroders

The following API call returns all work orders from your account.

URL: /v1/workorders

Method: GET

maintainx-5.png

Matches of the search can be found in the module's Output under Bundle > Body > workOrders

In our example 5 work orders were returned:

maintainx-4.png