> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# IBM Maximo

> Connect BonData to IBM Maximo for asset, work order, and maintenance data

IBM Maximo is an enterprise asset management (EAM) platform that tracks the full lifecycle of physical assets, from procurement and maintenance through to retirement across manufacturing, utilities, and facilities operations. With BonData, you can connect to your Maximo environment to read, enrich, and sync your asset and maintenance data within Agent workflows.

## IBM Maximo API Key Setup

BonData connects to Maximo through its REST/OSLC API using `maxauth` (API key) authentication. OAuth is also supported for environments that require it.

### Step 1: Confirm Your Maximo Base URL

1. Log in to Maximo as an administrator
2. Your base URL is the host that serves the Maximo application, for example `https://maximo.yourcompany.com/maximo` or `https://<host>/maximo/oslc` for Maximo Application Suite
3. Note this URL - BonData appends the REST/OSLC object paths (for example `/os/mxapiasset`) to it

### Step 2: Enable API Access and Create an API Key

1. Go to the **Administration** work center, or open the **Users** application
2. Ensure the integration user has a security group that grants access to the object structures (OS) you plan to use
3. In Maximo Application Suite, open the **API Keys** management page (or use the `apikey` endpoint) and generate a new API key for the integration user
4. **Copy the generated API key** - it is used as the `apikey` header on every request

<Note>
  For classic Maximo (7.6.x) without API key management, BonData can authenticate using the `maxauth` header, which is a Base64-encoded `username:password` credential. Use a dedicated service account for this.
</Note>

### Step 3: Grant Object Structure Access

1. Open the **Object Structures** application
2. Confirm the object structures you need are exposed as REST resources (for example `MXAPIASSET`, `MXAPIWODETAIL`, `MXAPIITEM`)
3. Make sure the integration user's security group has read access to each

### Step 4: Enter Credentials in BonData

1. In BonData, navigate to **Integrations** and select **IBM Maximo**
2. Enter your **Base URL** and **API Key**
3. Click **Connect**

## Required Fields

| Field    | Description                                                                                            |
| -------- | ------------------------------------------------------------------------------------------------------ |
| Base URL | Your Maximo host, including the application path (for example `https://maximo.yourcompany.com/maximo`) |
| API Key  | The `maxauth` API key generated for the integration user                                               |

## Available Data

Once connected, BonData can sync the following Maximo records:

* **Assets** - Asset master records with hierarchy, status, and location
* **Work Orders** - Corrective and planned work orders with labor, materials, and status
* **Locations** - Location hierarchy and operating context for assets
* **Items / Inventory** - Item master records and storeroom inventory balances
* **Purchase Orders** - Purchase orders and receipts for materials and services
* **Service Requests** - Incoming service requests and tickets
* **Preventive Maintenance** - PM schedules, frequencies, and generated work