MDM deployment guide
Deploy Punch List with Mosyle
Mosyle deploys the Punch List app and its enterprise license to your managed iPhones and iPads using App Configuration. You push one license key, and Pro unlocks automatically the first time each device opens the app.
Covers iOS and iPadOS.
Who this is for
Is this guide for you?
Apple-focused IT teams running Mosyle Business or Mosyle Manager who need to unlock Punch List Pro across a managed iPhone and iPad fleet.
Before you start
Prerequisites
- An active Mosyle tenant that can push managed app configuration to enrolled devices.
- For iOS and iPadOS: an Apple Business Manager account, linked to your MDM, with the free Punch List app licenses acquired under Apps and Books.
- Your Punch List license key, org ID, and org name from the setup email we send after purchase.
- Network access from devices to https://api.mypunchlistapp.com, the only domain Punch List needs to reach.
Deployment
Push the license key with Mosyle
You set three key/value pairs on the Punch List app. Your MDM delivers them to every managed device silently, and the app reads them on launch.
- 1
Add Punch List as a managed app
In Mosyle, add Punch List as an App Store app, acquired through Apple Business Manager (Apps and Books).
- 2
Open App Configuration
In the Punch List app settings, open the App Configuration section, where Mosyle lets you push key/value pairs to the app.
- 3
Set the three keys
Add the three keys below, each as a String value.
- 4
Assign and save
Assign the app to the device group or profile that targets your devices, then save. Devices receive the app and configuration on their next Mosyle check-in.
The three configuration keys
Set these exactly. Key names are case-sensitive, lowercase, with underscores. The example values below use a fictional organization for illustration.
| Key | Type | What to enter | Example |
|---|---|---|---|
license_key | String | Your license key from the setup email | pl_ent_acme_construction_a1b2c3d4e5f6 |
org_id | String | Your org ID from the setup email | acme_construction |
org_name | String | Your org name from the setup email | Acme Construction |
Important notes
- Mosyle manages Apple devices (iPhone, iPad, and Mac). For Android, use a Managed Google Play capable MDM. The same license key covers iOS and Android.
- Mosyle supports configuration variables, but Punch List's three keys take fixed String values from your setup email. Paste them exactly, with no extra whitespace.
Verify
Confirm Pro unlocked on a test device
Before rolling out to your full fleet, test activation on a single device.
- 1Open Punch List on a test device that has received the app and configuration from your MDM.
- 2On first launch the app briefly shows "Activating..." while it validates the license, usually 1 to 2 seconds on a normal connection.
- 3After validation the app opens straight to the main screen. No sign-in, no purchase prompt, no license code to type.
- 4To confirm Pro is active, open Settings and check that it shows "Licensed by [your organization name]" with Pro features unlocked and no upgrade prompts.
If the app does not activate within 30 seconds of first launch, check that the device received the configuration and that the three keys have no typos or extra whitespace, then email support@mypunchlistapp.com with your org ID.
Troubleshooting
Mosyle FAQ
- Where do I set the license key in Mosyle?
- In the Punch List app's App Configuration section. Add license_key, org_id, and org_name as String values.
- Does Mosyle handle Android?
- Mosyle manages Apple devices. Use a Managed Google Play capable MDM for Android. One license key covers both iOS and Android.
- Can I use Mosyle configuration variables for these keys?
- Mosyle supports configuration variables, but Punch List's three keys take fixed String values from your setup email. Paste the values exactly, with no extra whitespace.
- How soon do devices activate?
- On their next Mosyle check-in. Open Punch List on a test device and confirm Pro is unlocked before rolling out to the full fleet.
Ready to roll out Punch List?
Buy seats and get your license key, or talk to our team about your deployment.
enterprise@mypunchlistapp.comUsing a different MDM? See all deployment guides.