---
title: Retail | Metrc Error Notifications
description: There are a few errors that come from Metrc from time to time.
---

[Skip to content](https://support.blaze.me/hc/en-us/articles/retail-metrc-error-notifications#main-content)

[![BLAZE-Logo-Blue (2)](https://support.blaze.me/hs-fs/hubfs/BLAZE-Logo-Blue%20(2).png?width=140&height=37&name=BLAZE-Logo-Blue%20(2).png)](https://support.blaze.me?hsLang=en)

- [BLAZE US Knowledge Base](https://support.blaze.me/hc/en-us/articles)

Open main navigation

Close main navigation

- [BLAZE US Knowledge Base](https://support.blaze.me/hc/en-us/articles)

 Welcome to the Blaze US Knowledge Base! Find helpful reference by searching here...

- There are no suggestions because the search field is empty.

1. [BLAZE US Knowledge Center](https://support.blaze.me/hc/en-us/articles?hsLang=en)
2. [BLAZE Retail](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en)
3. [Metrc](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#metrc)

# Retail | Metrc Error Notifications

## There are a few system errors that can occur from Metrc from time to time. Please review this article from the links below to understand what these different error codes mean, what causes them, and how to resolve them.

1. [**401 Error: API Key is not authenticated**](https://support.blaze.me/hc/en-us/articles/retail-metrc-error-notifications#API)
2. [**500 Error: General Metrc error**](https://support.blaze.me/hc/en-us/articles/retail-metrc-error-notifications#general)
3. [**503 Error: Metrics API is down**](https://support.blaze.me/hc/en-us/articles/retail-metrc-error-notifications#Down)

- ### **401 Error: API Key is not authenticated**

#### **CAUSE:** This error is likely due to a user's permissions being changed within Metrc.

#### **RESOLUTION:** A new Metrc API Key will need to be generated and added to your BLAZE account.

#### **Step 1: Generate a new API key in Metrc**

1. Log in to Metrc.
2. Click the downward arrow near your name and select **API**.
3. Click **Generate**.
4. Copy the new API Key.

#### **Step 2: Update the API key in BLAZE**

1. Log in to BLAZE.
2. Navigate to **Global Settings** \> **Integration Settings** \> **Metrc**.
3. Click **Edit**.
4. Delete the old API key and paste the new API key.
5. Click the **magnifying glass** icon to the right.
6. Ensure the appropriate Metrc Facility is selected (this corresponds to your Metrc License).
7. Click **Save**.

- ### **500 Error: General Metrc error**

#### **CAUSE:** Metrc has indicated that when a server response of "500: An error has occurred" is returned, the initial action (POST) is actually successful despite the error message. If you receive a second error upon retrying, it is because the first attempt successfully used the tag, making it unavailable for the second attempt.

#### **RESOLUTION:** Metrc is actively working towards resolving these intermittent 500 errors to prevent further duplication issues.

#### If a successful POST created a duplicate in your system, the licensee must contact Metrc support directly for assistance in correcting inventory issues. You can reach them at:

- - #### **Email:** support@metrc.com
    - #### **Phone:** 1-877-566-6506

- ### **503 Error: Metrics API is down**

#### **CAUSE:** This error occurs when Metrc's API servers are down.

**NOTE:** This is different from Metrc's main servers being down. You will likely still be able to log in and use Metrc's web platform directly.

#### **RESOLUTION:** You will need to wait for Metrc's API servers to stabilize before the integration functions normally again. If you need to intake inventory immediately, you must bypass the integration temporarily by either using the [BLAZE PO](https://support.blaze.me/hc/en-us/articles/retail-purchase-order-po-overview?hsLang=en) system or adding the [batches manually](https://support.blaze.me/hc/en-us/articles/retail-adding-a-batch-of-inventory-to-a-product?hsLang=en).

**NOTE:** If you are looking for our troubleshooting guide on Metrc *submission* errors, please refer to this [article](https://support.blaze.me/hc/en-us/articles/retail-how-to-address-metrc-transaction-submission-errors?hsLang=en).

- [BLAZE Retail](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#main-content)

    - [FAQs](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#faqs)
    - [Ecommerce](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#ecommerce)
    - [Transactions](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#transactions)
    - [Loyalty / Marketing](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#loyalty-marketing)
    - [Members](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#members)
    - [Integrations](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#integrations)
    - [Reporting](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#reporting)
    - [Metrc](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#metrc)
    - [Delivery & Dispatch](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#delivery-dispatch)
    - [Getting Started](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#getting-started)
    - [BioTrack](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#biotrack)
    - [Promotions](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#promotions)
    - [Point of Sale (POS)](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#point-of-sale-pos)
    - [Purchase Orders](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#purchase-orders)
    - [Insights](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#insights)
    - [BLAZEPAY](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#blazepay)
    - [Compliance & Taxes](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#compliance-taxes)
    - [Inventory Management](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#inventory-management)
    - [Hardware & Labels](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#hardware-labels)
    - [Web POS App](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#web-pos-app)
    - [State Limits](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#state-limits)
    - [New Mexico S2S](https://support.blaze.me/hc/en-us/articles/blaze-retail?hsLang=en#new-mexico-s2s)
- [BLAZE ECOM](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#main-content)

    - [ECOM Mission Control](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#ecom-mission-control)
    - [Ecommerce](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#ecommerce)
    - [Onboarding](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#onboarding)
    - [Website Content](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#website-content)
    - [Mobile Apps](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#mobile-apps)
    - [SEO](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#seo)
    - [General](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#general)
    - [Promotions, Discounts & Rewards](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#promotions-discounts-rewards)
    - [Integrations](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#integrations)
    - [WordPress](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#wordpress)
    - [Order Notifications](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#order-notifications)
    - [Online Store Configuration](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#online-store-configuration)
    - [Customization](https://support.blaze.me/hc/en-us/articles/blaze-ecom?hsLang=en#customization)
- [BLAZEPAY](https://support.blaze.me/hc/en-us/articles/blazepay?hsLang=en#main-content)

    - [Cashless ATM](https://support.blaze.me/hc/en-us/articles/blazepay?hsLang=en#cashless-atm)
- [BLAZE Growth](https://support.blaze.me/hc/en-us/articles/blaze-growth?hsLang=en)
- [Ecommerce](https://support.blaze.me/hc/en-us/articles/ecommerce?hsLang=en#main-content)

    - [Online Store Configuration](https://support.blaze.me/hc/en-us/articles/ecommerce?hsLang=en#online-store-configuration)
- [Mobile Apps](https://support.blaze.me/hc/en-us/articles/mobile-apps?hsLang=en#main-content)

    - [Go To Market](https://support.blaze.me/hc/en-us/articles/mobile-apps?hsLang=en#go-to-market)
    - [Troubleshooting](https://support.blaze.me/hc/en-us/articles/mobile-apps?hsLang=en#troubleshooting)
    - [Push notifications](https://support.blaze.me/hc/en-us/articles/mobile-apps?hsLang=en#push-notifications)
    - [Onboarding](https://support.blaze.me/hc/en-us/articles/mobile-apps?hsLang=en#onboarding)
- [Payment Integrations](https://support.blaze.me/hc/en-us/articles/payment-integrations?hsLang=en#main-content)

    - [Birchmount](https://support.blaze.me/hc/en-us/articles/payment-integrations?hsLang=en#birchmount)
- [BLAZE Sites](https://support.blaze.me/hc/en-us/articles/blaze-sites?hsLang=en#main-content)

    - [SEO](https://support.blaze.me/hc/en-us/articles/blaze-sites?hsLang=en#seo)
    - [General](https://support.blaze.me/hc/en-us/articles/blaze-sites?hsLang=en#general)
    - [Widgets](https://support.blaze.me/hc/en-us/articles/blaze-sites?hsLang=en#widgets)
    - [BLAZE Widgets](https://support.blaze.me/hc/en-us/articles/blaze-sites?hsLang=en#blaze-widgets)
    - [3rd Party Apps](https://support.blaze.me/hc/en-us/articles/blaze-sites?hsLang=en#3rd-party-apps)
- [Company Products](https://support.blaze.me/hc/en-us/articles/company-products?hsLang=en)
- [SSO(Single Sign-On)](https://support.blaze.me/hc/en-us/articles/ssosingle-sign-on?hsLang=en)
- [BLAZE Brands](https://support.blaze.me/hc/en-us/articles/blaze-brands?hsLang=en)
- [Product Catalog](https://support.blaze.me/hc/en-us/articles/product-catalog?hsLang=en)
- [Compliance](https://support.blaze.me/hc/en-us/articles/compliance?hsLang=en#main-content)

    - [New Mexico](https://support.blaze.me/hc/en-us/articles/compliance?hsLang=en#new-mexico)

[![BLAZE-Logo-Blue (2)](https://support.blaze.me/hs-fs/hubfs/BLAZE-Logo-Blue%20(2).png?width=140&height=37&name=BLAZE-Logo-Blue%20(2).png "BLAZE-Logo-Blue (2)")](http://blaze.me)

BLAZE US Help Center

Copyright © 2026, BLAZE Solutions Inc.