This article details how to add individual Metrc API keys for each Dutchie POS user. This is required in states including Colorado, Maryland, Massachusetts, New York, and Oklahoma.
Verify employee permissions in Metrc
Any Metrc user can generate an API key in Metrc; there's no special permission required just to generate one.
However, the permissions required for that key to work properly with Dutchie depend on the type of key:
- Master/facility-level key — The Metrc user associated with this key needs full permissions on the license (sales/dispensing, packages/inventory, transfers, adjustments, etc.) or the integration will fail for any action outside their permission set.
- Individual user keys — Each user needs at minimum the permissions matching their role (e.g., budtenders need sales/dispensing; anyone processing adjustments needs Packages - Adjust permission in Metrc, etc.)
See Metrc permissions overview for more information.
Collect your employees' API keys from Metrc
- Ask your employee to log in to Metrc using their own Metrc login.
- From the user avatar menu, select API Keys.
- Click Generate.
- Copy the entire API key from the Current API Key field.
Add your employee's API keys to Dutchie POS
- In the Dutchie Backoffice, go to Settings > Integrations > Metrc > Settings tab.
- Set Require Individual User API Keys to Yes.
- Click Update.
- On the User keys tab, select the employee's user profile.
- Paste the API key you copied from Metrc into the API key field.
- Click Save.
- Repeat this process for all Dutchie POS users. Make sure each user also has the appropriate permissions in Metrc for their role.
Troubleshooting
If an employee with a Metrc API key attached to their Dutchie user profile gets an error when they log into Dutchie or ring up sales, such as an Unauthorized Metrc error, this could be due to the user not having the appropriate permissions in Metrc, or the API key itself could be invalid.
- In the Dutchie Backoffice, go to Settings > Integrations > Metrc.
- Select the Validate key tab.
- From the Validating key for: dropdown, select either Master Key (the key associated with the primary admin user for your Metrc license) or a specific user.
- If the Status column shows Success on some lines but Failure on others, this likely means the key itself is valid but the associated Metrc user profile doesn't have certain permissions. Check the user's permissions in Metrc and update them as needed. Note that some lines might not be relevant for your license/facility type; e.g., a failure for Plants and Harvests is not a concern for dispensaries.
- If the Status column shows Failure on every line, regenerate the key and paste the new key into Dutchie as shown above.