MDM deployment guide
Deploy Punch List with Hexnode
Hexnode UEM deploys the Punch List app and its enterprise license to your managed iPhones, iPads, and Android devices using app configuration. You push one license key, and Pro unlocks automatically at first launch.
Covers iOS, iPadOS, and Android.
Who this is for
Is this guide for you?
IT administrators running Hexnode UEM who need to roll out Punch List Pro across a mixed construction fleet.
Before you start
Prerequisites
- An active Hexnode 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.
- For Android: Managed Google Play access, with Punch List approved for your organization.
- 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 Hexnode
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 to the app inventory
In the Hexnode UEM console, add Punch List to your App Inventory: an App Store app for iOS and iPadOS, or a Managed Google Play app for Android.
- 2
Add the app configuration
On iOS, attach an app configuration (Hexnode accepts an XML key/value dictionary that deploys alongside the app). On Android, use the Android Enterprise managed configuration form.
- 3
Set the three keys
Add the three keys below, each as a String value.
- 4
Deploy
Deploy the app to the target device group or policy. The configuration is applied as the app installs, and Punch List activates on first launch.
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
- On Android, Hexnode reads the available keys from the schema the app publishes to Managed Google Play, so the three keys appear once the Punch List Android build declares them. If they are not listed, email support@mypunchlistapp.com.
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
Hexnode FAQ
- Does Hexnode support both iOS and Android?
- Yes. Add Punch List from the App Store for iOS and iPadOS and from Managed Google Play for Android, and set the same three keys on each.
- How does Hexnode deliver the configuration?
- On iOS it deploys an XML key/value dictionary alongside the app install. On Android it uses Android Enterprise managed configuration. Either way the app reads the keys on launch.
- The Android keys are not showing in Hexnode.
- Hexnode reads the Android keys from the schema the app publishes to Managed Google Play. If they are not listed, the Android build has not declared them yet. Email support@mypunchlistapp.com.
- When does Pro unlock?
- The configuration applies as the app installs, then Punch List activates on first launch. Confirm on a test device before a full rollout.
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.