> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/mdm/apple-business-manager.md).
# Apple Business Manager
Apple Business Manager is Apple's platform for deploying and managing Apple devices at scale. It provides zero-touch enrollment, automated app distribution, and streamlined device management for organizations. Connecting Apple Business Manager to Harmony enables automated device provisioning and intelligent fleet management.
Harmony authenticates securely with Apple Business Manager using OAuth and automatically refreshes the connection in the background, so your data stays up to date without any manual intervention. ABM device data is enriched at query time rather than during sync, which means asset information remains accurate and consistent even as your fleet changes.
#### What the Apple Business Manager integration enables
| Capability | Description |
| ------------------------- | ------------------------------------------------------------------------- |
| Device Enrollment | Automate device enrollment through DEP |
| MDM Integration | Coordinate with MDM solutions (Jamf, Kandji, Intune) |
| Purchase Tracking | Track device purchases and serial numbers |
| Warranty Tracking | Fetch real warranty end dates via AppleCare Coverage API |
| Released Device Detection | Automatically detect and update status when devices are released from ABM |
#### Prerequisites
* **Apple Business Manager Admin**: Administrator or Device Enrollment Manager role
* **API Credentials**: Private key and client ID from Apple Business Manager
* **Harmony Account**: Active Harmony workspace
#### Connect Apple Business Manager to Harmony
**Step 1: Generate API Credentials in Apple Business Manager**
1. Sign in to [business.apple.com](https://business.apple.com)
2. Go to **Settings** > **Apps and Books**
3. Navigate to **API Keys** section
4. Create a new API key and download the private key file (.pem)
5. Note the **Key ID** and **Client ID**
**Step 2: Navigate to Integrations**
1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **Apple Business Manager** under **MDM** and click **Connect**
**Step 3: Configure Connection**
1. Enter an **Instance name** for your Apple Business Manager connection
2. Enter your **Key ID** (Apple Private Key ID)
3. Enter your **Client ID** (Apple Business Manager Client ID)
4. Upload your **Private key** by dragging and dropping your PEM file directly into the upload field (or click to browse for the file)
5. Click **Connect**
{% hint style="info" %}
You no longer need to copy and paste certificate contents manually. The file upload field accepts .pem and .key formats, eliminating formatting errors that could occur during manual entry.
{% endhint %}
#### What Harmony Syncs
**From Apple Business Manager:**
* Device serial numbers and models
* Device color and product type
* Storage capacity (e.g. 512GB)
* Purchase dates, order numbers, order dates, purchase source type, purchase source ID, and part number
* Device enrollment status
* Ownership status (including Company, Personal, and Released)
* Warranty end dates (fetched directly from Apple's AppleCare Coverage API)
ABM data is matched to asset records by serial number and is only applied when a field is empty or missing, so existing values are always preserved. This enrichment works even when no MDM connection is configured.
#### Warranty Date Accuracy
Harmony retrieves warranty end dates for Apple devices by querying Apple's AppleCare Coverage API directly. This means your asset records reflect actual coverage periods, including extended AppleCare plans where applicable. If coverage data is unavailable for a specific device, Harmony falls back to estimating the warranty end date using purchase date plus one year.
#### Released Device Tracking
When a device is released from Apple Business Manager, Harmony automatically detects the change and updates the asset's ownership status to **Released**. This keeps your inventory accurate without requiring manual updates when devices are offboarded.
You can filter the asset table by ownership type - including Company, Personal, and Released - to get a focused view of your fleet's current state.
#### Apple Bluetooth Device Recognition
Harmony correctly identifies Apple Bluetooth accessories - including AirPods, keyboards, mice, and other Bluetooth peripherals - by their actual model names. Apple Bluetooth product IDs are included in the device catalog, so these devices no longer appear as unknown or generic entries in your inventory.
#### Use Cases
Zero-Touch Onboarding
New hire receives device, powers on, all apps and settings configured automatically
Bulk Device Deployment
Order 50 MacBooks, automatically assign to new employees
VPP License Management
Track and assign app licenses based on roles
Device Lifecycle
From purchase through deployment to retirement
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.harmony.io/integrations/mdm/apple-business-manager.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.