Use this article as a Dutchie POS Administrator or Inventory Manager to troubleshoot and resolve Metrc integration failures caused by invalid, expired, or improperly configured API keys.
What is the issue?
When an API key is invalid, Dutchie cannot communicate with Metrc. This prevents real-time reporting of sales, inventory adjustments, and manifest intake, which interrupts your operations and can lead to compliance violations if not resolved quickly.
What’s causing the issue?
Failures are usually caused by an expired API key in Metrc, a key being regenerated without being updated in Dutchie, or a lack of necessary permissions assigned to the Metrc user profile associated with the key.
Keep in mind
There are two types of Metrc API keys:
- An admin or master key that is associated with a specific user but is also used as the main key for your facility that links Dutchie POS to Metrc.
- Individual user keys, which are secondary keys required in some markets for all users who manage inventory or process transactions. These allow the integration to attribute actions in Dutchie to a specific user in Metrc.
- Learn more:
How do I solve the issue?
For the master key for your facility:
- Log in to your Metrc account.
- Click the user avatar in the upper right and select API Keys.
- Click Generate.
- Copy the new key from the Current API Key field.
- Log in to the Dutchie Backoffice.
- Navigate to Settings > Integrations > Metrc.
- On the Settings tab, paste the new key into the API Key field.
- Select the Validate Key tab to confirm the connection status is Success.
For individual user keys:
- Ask your employee to log in to Metrc using their own Metrc login.
- Click the user avatar in the upper right and select API Keys.
- Click Generate.
- Copy the new key from the Current API Key field.
- Log in to the Dutchie Backoffice.
- Navigate to Settings > Integrations > Metrc.
- On the User keys tab, select the employee's profile.
- Paste the new key into the API Key field and click Save.
- Select the Validate Key tab to confirm the connection status is Success.
Commonly Asked Questions
- Why can't Dutchie connect to Metrc?
- Why is my Metrc integration not working?
- Why are my sales not reporting to Metrc?
- Why aren't my inventory adjustments syncing to Metrc?
- Why can't I receive manifests in Dutchie?
- I'm getting an API key error for Metrc — what does that mean?
- How do I fix a Metrc integration failure?