Set Up Guide

Required Info

Before setting up the integration in MyBlackbird, you will need to obtain their specific integration information, as well as the version of Treez you are using. Each Treez account has specific keys that allow third party software platforms to share and receive select information. The following keys are needed to securely integrate your Treez account with Blackbird. All of the fields listed below will be provided to the you by your Treez account representative on request.

Configuration Fields

Key

Description

How to Find It

API Key
REQUIRED

This is a long string of letters and numbers that is specific to each Treez account.

Provided by a Treez Account Rep.

Treez provides specific documentation on how clients should request API keys - found here.


Note: You should put themselves as the Customer Contact to ensure they are the one to receive the key from Treez.

Client ID
REQUIRED

This is a long number that is specific to each Treez account.

Provided by a Treez Account Rep.

You will need to specifically ask for this field to be included in the request form they send to Treez (mentioned above), as it is not included by default in the provided message.

Dispensary Name
REQUIRED

The Dispensary Name in this case is the name used in the login portal link the client uses to access their Treez account.

For example: https://yourdispensaryname.treez.io/
The Dispensary Name would be in the place of ‘yourdispensaryname’.

Can be found in portal link the you use to log in to Treez.

API Version
REQUIRED

Treez supports two versions of the API - V1 and V2. This will determine which integration type clients select from when setting up their integration.

You should ask your account representative when obtaining the above credentials if you are not sure what version they are on.

Most will use V2, and that can be tried first if you are not sure.

Set Up Steps

Once you have obtained all the required information from Treez, setting up the integration is as simple as entering those fields into MyBlackbird. Navigate to your Settings & Configurations Block and then choose the Integrations Hub Block.

Enter Authorization Info

Select either Treez V1 or Treez V2 from the Point of Sale drop-down depending on which API version is being used and enter Client ID, API Key and Dispensary Name.

Functionality

Once the authorization information is entered, you will be prompted to choose the sync functionality they would like to have with the integration.

Product Sync - You should enable this if you plan to use the integration to facilitate an online menu. This sync will pull inventory from Treez for all inventory that is active, in-stock and in an inventory location that is Sellable. New and updated products will sync every 5 minutes .

Order Push - You may want to enable order push functionality to send new online orders directly to their Treez account for fulfillment. This will remove the need to manually recreate customer profiles and orders in Treez. Orders will be pushed directly to Treez in real time as they are received.

Customer Sync - You should enable this if you plan to use a loyalty program where customers earn points for completed orders. This sync pulls customer information from Treez into Blackbird and allows Blackbird to associate customer info with orders, when available. New and updated customer information is pulled into Blackbird every 3 hours.

Order Sync - You should enable this if you plan to use a loyalty program where customers earn points for completed orders. This sync pulls in order information for completed orders in Treez. When used with a loyalty program, orders will be used to award customers points for their purchase. Order syncs run every 3 hours.

Notification Email - Adding a notification email is optional for those using a menu. It is used to send email notifications of new orders received on a Blackbird menu. It is not necessary to use this if order push is enabled, but can be a nice additional feature to make sure staff is getting notified of new orders that need to be fulfilled.

Activate Integration

Once all info is added and the desired functionality is enabled, the last step is to set the integration Active and save the configuration information. The integration can be deactivated at any time.

Monitoring Integration Activity

Monitoring the information shared between Treez and Blackbird is easy! Users can navigate to the Activity Log within their Integration Hub to see what information is being pulled from Treez, how frequently new info comes in and if there are any errors with the integration.

Was this article helpful? Let us know below! We’re always trying to improve and would love to see your feedback.

If you have any further questions, feel free to reach us anytime by clicking on the help chat in the bottom left of your screen. We’re always happy to help!

Did this answer your question?