Managing Your METRC API Key in DistruLabels
During your initial account setup, you'll be prompted to add your METRC API key. This guide covers how to manage and update that API key after onboarding is complete.
Which API Key Should You Use?
Use a company-wide METRC API key with the highest level of access available—typically one generated by your METRC administrator.
Required permissions:
Access to Packages - in permissions this will mean you can Manage Packages
Permission to generate Retail IDs - - in permissions this will mean you can Manage Product Labels
Using an admin-level key ensures DistruLabels can access all the data it needs across your organization.
Locating the Company-Wide Key
The company-wide API key is typically managed through the administrative section, as it is used for organizational integration:
Log into your METRC account using an administrator or owner login.
Navigate to the main menu bar and click on the Admin section.
Look for and select the API Key or Integration Settings option.
If a key is already listed, use that one. If no key exists, click Generate to create the company key.
Locating Your Personal Key (For Reference)
If you need to verify your personal API key (not recommended for company-wide integrations), you will find it by clicking on your name in the top right corner and selecting API Keys.
⚠️ Important: Do NOT regenerate a key if one already exists. Regenerating will immediately invalidate the old key and break the connection in any system currently using it.
Verifying Permissions
Before using your API key, confirm it has the required permissions:
Packages (View access)
Package Labels (Manage access)
Without these permissions, DistruLabels won't be able to sync your data or generate MRIDs.
Data Syncing
Once your API key is connected, DistruLabels will automatically sync your packages and associated METRC Retail IDs every 3 minutes. This keeps your label data current with your METRC account.