Sync Apple devices from SimpleMDM into SimpleAMS

SimpleMDM is the popular lightweight alternative to Jamf for small and mid-size Apple fleets. Setup is a single API key paste - SimpleAMS pulls every managed device on demand and on a daily schedule after that.

1. Generate an API key in SimpleMDM

1. Log into SimpleMDM as an account admin.
2. Go to Settings → API.
3. Click Add API Key. Give it a name like SimpleAMS.
4. Copy the resulting key. It's shown only once.

2. Paste into SimpleAMS

1. Go to Settings → Integrations → SimpleMDM.
2. Paste the key into API key.
3. (Optional) If you keep your asset tags inside a SimpleMDM custom attribute, enter the attribute name in Asset tag custom attribute name. Leave blank to default to SimpleMDM's built-in field, falling back to the serial number.
4. Tick Enable this integration and save.

3. Run a sync

Click Sync now. SimpleAMS hits the SimpleMDM /api/v1/devices endpoint, pages through every device with cursor-based pagination, and creates / updates an asset row per device. Daily after that.

4. What gets imported

• Every device SimpleMDM is currently managing - Macs, iPhones, iPads, Apple TVs.
• Asset tag = your configured custom attribute value → built-in asset tag → serial number, in that order.
• Model name from SimpleMDM's model_name field (auto-creates the model in SimpleAMS if missing).
• Manufacturer is set to Apple.
• Assigned user comes from the device's user email, matched to your existing staff by email.

5. Tips

• The API key is account-wide; one key syncs every device in the SimpleMDM tenant.
• Devices without a serial number are skipped - SimpleAMS dedupes on serial.
• If a device is managed by both Jamf and SimpleMDM (unusual), the last sync wins by asset_tag - decide which is your source of truth and enable only one.
• The sync is read-only by default. SimpleMDM stays the authority for device commands; SimpleAMS just mirrors the inventory.