> For the complete documentation index, see [llms.txt](https://prohelp.assetpanda.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prohelp.assetpanda.com/integrations-store/device-management/apple-business-manager-integration.md).
# Apple Business Manager Integration
You can integrate Apple Business Manager with Asset Panda Pro to streamline the management of Apple devices across the organization. This connection synchronizes detailed device information into Asset Panda Pro, granting a comprehensive and real-time perspective of the entire Apple device inventory.
## **Prerequisites**
* Access credentials, API private key, and API tokens for Apple Business Manager
* Asset Panda Pro account with appropriate permissions
* Network connectivity that allows API communication between Asset Panda Pro and Apple Business Manager
***
## Generate the Apple Business Manager API Key
You must secure the API key from Apple Business Manager before you set up the integration in Asset Panda Pro:
1. Log into [Apple Business Manager](https://business.apple.com/).
2. Click your profile name in the bottom-left corner of the screen.
3. Select **Preferences**.
4. Open the **API** section.
5. Under **API Accounts**, click **Create API Account**.
6. Enter a label for the API account.
7. Click **Manage** and then copy and save the **Key ID** and **Client ID**.
8. Download the private key file (**.pem** format) and store it in a secure location.
{% hint style="warning" %}
The private key (.pem file) can only be downloaded during creation. Store it securely, because it cannot be downloaded or retrieved again later.
{% endhint %}
***
## Add the Apple Business Manager integration
1. Log into Asset Panda Pro with an administrator account.
2. Navigate to 
**Settings** > **Account Management**.
3. Expand the appropriate account and module.
4. Click **Manage** in the **Integrations** card.
5. Select **Integrations Store**.
6. In the **Apple Business Manager** tile, click **Add**. The **Integrations in this module** tab is displayed.
7. In the **Apple Business Manager** tile, click **Configure**.
8. Enter the following details to authenticate Asset Panda Pro with Apple Business Manager:
* **Client ID**: Paste the Apple Business Manager Client ID copied from the Apple Business Manager portal.
* **Key Id**: Enter the Key ID associated with the Apple Business Manager account.
* **Private Key (.pem)**: Upload the private key (.pem) file downloaded from Apple Business Manager.
9. Select **Test and save connection**. If the connection is valid, a success message is displayed and a green check is displayed above the **Authentication** tab.
10. Click **Continue with mapping**.
11. Create a mapping to define the device data from Apple Business Manager to sync with a specific collection in Asset Panda.
1. Click **Add mapping option**.
2. For **Mapping Name**, enter a descriptive name for the mapping. For example: `Apple Devices.`
3. **Sync direction** is set to one-way from Apple Business Manager to Asset Panda by default.
4. For **External Entity**, select `Devices`.
5. Choose the **Collection** in Asset Panda where the device data is stored.
6. Map each data field from Apple Business Manager (ABM) to the relevant field in your Asset Panda Pro collection to ensure correct device tracking. See [Available ABM device fields and unique identifiers](#available-abm-device-fields-and-unique-identifiers).
{% hint style="info" %}
Select a unique identifier field that guarantees each device is stored without duplication:
* Always select **Serial Number** as the primary unique identifier, if possible, because it is consistently unique across all Apple devices.
* Only fields marked as unique in Asset Panda collections are available for use as unique identifiers.
{% endhint %}
12. Click **Save**.
### **Available ABM device fields and unique identifiers**
| **Field Name** | **Description/Usage** | **Unique Per Device?** | **Recommended for Identifier** |
| ----------------------- | --------------------- | ---------------------- | ------------------------------ |
| Serial Number | Device’s Apple serial | Yes | Recommended |
| IMEI | Cellular module code | Yes (cellular only) | For cellular devices |
| MEID | Alternate cellular ID | Yes (cellular only) | For cellular devices |
| EID | eSIM identifier | Yes (eSIM only) | Not all devices |
| Bluetooth MAC Address | Bluetooth hardware ID | Yes | Alternate |
| WiFi MAC Address | WiFi hardware ID | Yes | Alternate |
| Device Model | Apple model name | No | No |
| Product Type | Device category | No | No |
| Status | Current device state | No | No |
| Color | Device color | No | No |
| Added to Org Date Time | Enrollment date | No | No |
| Order Number | Purchasing reference | No | No |
| Part Number | Apple SKU | No | No |
| Purchase Source ID/Type | Asset purchase method | No | No |
| Device Capacity | Storage size | No | No |
| Product Family | Broad Apple group | No | No |
| Updated Date Time | Last update timestamp | No | No |
---
# 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:
```
GET https://prohelp.assetpanda.com/integrations-store/device-management/apple-business-manager-integration.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.