Skip to main content

Find and Update Metrc API keys for Users and Facilities

Natalie M.
  • Updated

As part of setting up Canix with Metrc, you will need to access your Metrc API key. This will enable Canix to send and retrieve data from your Metrc account. Canix is listed as a validated third-party Metrc provider under the name “Entrc Inc. DBA Canix” and all submissions made from Canix will show in Metrc as being submitted via "Canix.com". 

This article covers:

  1. Find your Metrc API Key
  2. View Facility API Keys
  3. Update Facility API Keys
  4. View User API Keys
  5. Update User API Keys
  6. Troubleshooting

Find your Metrc API Key (in Metrc)

  • Do not print, write down, or share your Metrc API key with anyone other than a validated Metrc integrator. 
  • You must have Metrc admin access to generate the API Key for your Canix facility.
  • Metrc's user permissions are view-only by default. Enable the permissions you need in Metrc from Admin > Employees > Edit Employee with the API key being used.

On the web:

  1. Log in to your Metrc account
  2. Select your user profile on the top right side of the page
  3. Select API Keys
  4. Click Generate
  5. Copy the entire Current API Key
  6. Save this key in a safe place, follow the instructions in the next two sections to connect your Metrc and Canix instance

metrc_api_key_generate.png

View Current Facility API Keys (in Canix)

To view your current Facility API Keys assigned in Canix, navigate to Admin > Facility Management.

FacilityManagement_API_Keys.png

Update Facility API Keys (in Canix)

You must be a Canix admin to do this.

First, check that the correct permissions are available with these steps. 

  1. In the Canix web application, navigate to Admin > Integrations
  2. Input the facility's API key in the box Paste your API key here...
  3. Using the checkboxes next to each license, select the facility or facilities you wish to update
  4. Click Update Selected Facilities

If the Metrc API Key you have input does not get green checks for all sections, you may want to confirm if the correct permissions are enabled in Metrc before using Update Selected Facilities in Canix. Please note: Some licenses will not have access to certain sections, such as Distribution Licenses not having permission for Plants, which is expected. Troubleshooting: Metrc API Key Errors

update-facility-api-key-integrations.png

View Current User API Keys (in Canix)

To view your current User API Keys assigned in Canix, navigate to Admin > User Management. These can be updated or edited by following the steps below.

UserManagement_User_API_Keys.png

Update User API Keys (in Canix)

The Facility API Key and the Metrc Super Admin (primary Canix Admin) User API Key must match. Generating a new API Key will invalidate either the facility or primary Canix Admin key. 

You must be an Admin in Canix to do this.

Canix uses an individual's Metrc API Key to correlate the work they are doing in Canix with the associated submissions sent into Metrc. You can track the Canix user who submitted these requests under Admin > Metrc Submissions > All.

To ensure that Metrc submissions are tied to the user who submitted it from Canix, rather than the facility, you can assign each user their Metrc API Key from their Metrc account to their Canix user.

  1. Using the steps above in "Find your Metrc API Key", have each employee provide you with their unique Metrc API Key

  2. Navigate to the User Management page

  3. Click the user's name

  4. Add the key under Metrc API Key

  5. Select Update.

edit-user-api-key.png

  • For any Canix User that has permission to submit directly to Metrc but does not have their own Metrc User Key assigned to them in Canix, their submissions will show in Metrc with the name of the Facility Key owner. This is not compliant and is why each Canix User should have their own Metrc User Key assigned if they will be submitting directly to Metrc.

If you are encountering issues with your Metrc API Keys or Metrc Submissions that this article has not resolved, please see Troubleshooting: Metrc API Key Errors

Related articles