Apple School Manager to Assets

Buzz

This guide is for Higher Ed and K12 IT teams that use Apple School Manager. We show you how you can manage devices in Assets.

Quick preview of other sources you can import to Assets

Source	What it brings into Assets
Apple Business	Apple devices for organizations on Apple Business, the counterpart to Apple School Manager
Personio	Employee records from Personio HR
Snowflake	Data from any Snowflake tabels to Assets
ServiceNow	Data from ServiceNow CMDB to Assets
Jamf Pro	Mobile devices and computers from Jamf Pro, the common pairing with Apple School Manager

What the Apple School Manager API gives you

The Apple School Manager API is a REST API for the devices your institution enrolls through Automated Device Enrollment. This guide uses one endpoint, Get Organization Devices, which returns every device in your organization with its hardware, order and purchase details.

The same API also covers:

Device information for a single device
AppleCare coverage for a device
Device management services (your MDM servers) and the devices assigned to each
Activation Lock status

Step 1: Connect

Apple School Manager uses OAuth 2 with a private key, so there’s no password to share. You create an API account in Apple School Manager, then give OnLink its credentials.

In Apple School Manager (Apple’s guide)

Sign in as an Administrator or Site Manager.
Select your name at the bottom of the sidebar, then Preferences > API > Get Started. Name the account and select Create.
Select Generate Private Key. A .pem file downloads once, so store it somewhere safe.
Select Manage to see the account’s Client ID and Key ID.

In OnLink

Create a new Assets Data Source and choose the Apple School Manager template.
Enter the Client ID, Private Key, Apple Team ID and Apple Client ID.
Set the scope to school.api. (Apple Business uses business.api instead.)
Save.

Step 2: Get device details

Configure the request in the data source:

Setting	Value
Method	`GET`
URL	`https://api-school.apple.com/v1/orgDevices`
Response data path	`data`
Pagination	Cursor-based (`meta.paging.nextCursor`, 100 devices per page)

Save and run it to pull sample data. Each device comes back like this (trimmed):

{

“type”: “orgDevices”,

“id”: “XABC123X0ABC123X0”,

“attributes”: {

“serialNumber”: “XABC123X0ABC123X0”,

“deviceModel”: “iMac 21.5\””,

“productFamily”: “Mac”,

“deviceCapacity”: “750GB”,

“color”: “SILVER”,

“status”: “UNASSIGNED”,

“orderNumber”: “1234567890”,

“addedToOrgDateTime”: “2025-04-30T22:05:14.192Z”

}

This is one example. You can point the same data source at any Apple School Manager endpoint, such as a device’s AppleCare coverage.

Step 3: Map fields

Create the Assets import (JSM Assets Data Synchronization), then map Apple fields to your Assets attributes. Use one key: line so OnLink knows when to update an existing object instead of creating a new one. Serial number is the natural choice.

OnLink mapping	What it stores
`key:serialNumber=Serial Number`	Unique key for matching objects
`map:deviceModel=Device Model`	Model, such as iPad (10th generation)
`map:productFamily=Product Family`	Mac, iPad, iPhone, Apple TV
`map:productType=Product Type`	Apple hardware identifier
`map:deviceCapacity=Device Capacity`	Storage size
`map:color=Color`	Device color
`map:status=Status`	Assigned or unassigned to an MDM server
`map:orderNumber=Order Number`	Purchase order number
`map:orderDateTime=Order Date Time`	When the device was ordered
`map:addedToOrgDateTime=Added to Org Date Time`	When it joined Apple School Manager
`map:releasedFromOrgDateTime=Released from Org Date Time`	When it was released
`map:wifiMacAddress=Wi-Fi MAC Address`	Wi-Fi MAC, handy for network teams
`map:imei=IMEI`	IMEI for cellular devices

The full setup guide lists every supported field.

Bring your Apple School Manager devices into Assets

OnLink connects Apple School Manager, your MDM and your HR systems to Jira Service Management Assets, with 100+ connectors in one app. Set up the Apple School Manager template once and give your service desk the full device picture.

Try OnLink on the Atlassian Marketplace or talk to our team.

FAQ

We already sync Jamf (or Intune, Kandji/Iru) to Assets. Why add Apple School Manager? They answer different questions. Apple School Manager is the purchase record: what you bought, when, on which order, and which MDM server it’s assigned to. Your MDM knows the device’s current state. Import both and key them on serial number, and you can spot devices you own that never enrolled.

Which devices does the API return? Devices in your organization that enroll through Automated Device Enrollment: those bought from Apple or an authorized reseller or carrier, plus any added with Apple Configurator.

Who can create the API account? An Administrator or Site Manager in Apple School Manager. You can have up to 50 API accounts, so you can keep one just for OnLink.

Does this bring student or staff personal data into Jira Service Management? No. The organization devices endpoint returns hardware, order and purchase details. It has no student or staff names.

Can we import AppleCare coverage too? Yes. Add a second data source that calls the AppleCare coverage endpoint and map it to the same object type, keyed on serial number. Your service desk then sees warranty status right on the device.