OnLink · Device management
OnLink imports mobile device details from Jamf Pro into Jira Service Management Assets through the Jamf Pro API.
Three steps, no scripts. The same pattern covers computers, users and any other Jamf Pro endpoint.
The example uses /api/v2/mobile-devices. Jamf also serves v3 and v4; pick one version per data source and check its field names in Fetch API Sample before mapping.
section=GENERAL§ion=HARDWARE keeps the response small and the sync fast. Add SECURITY or USER_AND_LOCATION when you map those fields.
mobileDeviceId is stable and always returned. Keying on display name or serial breaks the moment a device is renamed or swapped.
Before you start, have these ready:
https://yourserver.jamfcloud.comThen set up the connection:
This example uses the Jamf Pro API v2 mobile devices endpoint. It’s just one example: OnLink can call any supported Jamf Pro API or Classic API method, including v3 and v4 endpoints.
In the OnLink endpoint configuration:
https://yourserver.jamfcloud.com/api/v2/mobile-devicessection=GENERAL§ion=HARDWARE. The Jamf API reference lists every section.Click Fetch API Sample to preview the Jamf response. You’ll use it to confirm field paths in the next step.
Mapping rules tell OnLink which Jamf field fills which Assets attribute. Two keywords do the work:
key sets the unique ID OnLink uses to match and update existing Assets objects.map links a Jamf field path to an Assets attribute. Nested fields use dot notation, like general.osVersion.Here’s a starter mapping for mobile devices:
|
OnLink mapping
|
What it stores
|
|---|---|
key:mobileDeviceId=id |
Unique key; repeat syncs update the existing object
|
map:deviceType=Device Type |
iPhone, iPad, Apple TV
|
map:general.displayName=Name |
Device name shown in Jamf Pro
|
map:general.osVersion=OS Version |
iOS, iPadOS or tvOS version
|
map:general.ipAddress=IP Address |
Last reported IP
|
map:lastEnrolledDate=Last Enrolled Date |
When the device enrolled
|
map:hardware.serialNumber=Serial Number |
Serial, the natural join to Apple Business or Apple School Manager
|
map:hardware.model=Model |
Hardware model
|
map:userAndLocation.username=Assigned User |
Who the device is assigned to
|
Start with a few fields, check each path against the API sample, then add more. Serial number, model, assigned user and security status are all in the response when you need them.
To run it, click Get Data, wait for Job Logs to show No more pending records, then click Import. Add a schedule and Assets stays in sync with Jamf Pro on its own.
/api/v1/computers-inventory with the same OAuth client, key on id and map general.name, operatingSystem.version and hardware.serialNumber. Macs and mobile devices then live side by side in Assets.
No scripts to write or maintain. OnLink connects Jamf Pro, and 100+ other HR, identity and device sources, to JSM Assets in one app.
Yes. Mobile devices are just the example. Swap in any supported Jamf Pro API or Classic API endpoint, then update the mapping to match that response.
Read access only. Create a Jamf API role and client that can read the data you want to import, and give OnLink its client ID and secret.
No. OnLink uses the key field to match existing Assets objects and update them. Pick a field that is unique and always returned by the API.
Set a schedule in OnLink. It runs Get Data and Import automatically, so Assets reflects Jamf without manual runs.
Compare your mapping path with the Fetch API Sample response; nested fields need dot notation, like general.osVersion. If nothing imports at all, check the endpoint URL and the API client’s permissions.
Yes, two kinds. Pio sells a dedicated Jamf Importer app. OnLink imports Jamf Pro alongside Intune, Iru, Workspace ONE, Apple Business and 100+ other sources in one app at one price, with no limit on connections. Here is how they compare.
Yes. Key the Jamf import and the Apple Business or Apple School Manager import on serial number into the same object type, and Assets shows the purchase record next to the live MDM state for every device.
Jamf Pro data in Assets
Start a free trial of OnLink on the Atlassian Marketplace. Jamf Pro, Intune, Iru, Apple Business and 100+ more in one app.
Try OnLink free on the Atlassian Marketplace and import your first Jamf Pro devices today.
With Jamf Pro data in Assets, your team can:
RELATED