MDM deployment guide
Deploy Punch List with Kandji
Kandji deploys the Punch List app and its enterprise license to your managed iPhones and iPads using a Library Item with app configuration. You set 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 Kandji who need to unlock Punch List Pro across a managed iPhone and iPad fleet.
Before you start
Prerequisites
- An active Kandji 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 Kandji
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 Library Item
In your Kandji tenant, go to Library and add Punch List as an App Store app (acquired through Apps and Books in Apple Business Manager).
- 2
Turn on app configuration
Open the Punch List Library Item and scroll to the bottom, then check Set app configuration to enable the managed configuration dictionary.
- 3
Set the three keys
In the configuration dictionary, add the three keys below, each as a String value.
- 4
Assign and save
Scope the Library Item to the Blueprint or Assignment Rule that targets your devices, then save. Kandji enforces the configuration and updates it on devices automatically if you change it.
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
- Kandji manages Apple devices (iPhone, iPad, and Mac) only. For Android, use a Managed Google Play capable MDM such as Intune, Workspace ONE, or Hexnode. The same license key works on both.
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
Kandji FAQ
- Where is app configuration in Kandji?
- Open the Punch List Library Item and scroll to the bottom, then check Set app configuration. Add the three keys as String values in the dictionary.
- Does Kandji support Android?
- No. Kandji manages Apple devices only. Deploy Punch List to Android with a Managed Google Play capable MDM such as Intune, Workspace ONE, or Hexnode. The same license key works on both.
- What happens if I change the license key later?
- Kandji enforces the configuration going forward and pushes updates to devices automatically, so editing the value in the Library Item updates enrolled devices.
- How do I target only some devices?
- Use Blueprints or Assignment Rules to scope the Punch List Library Item to the devices that should receive it.
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.