1. Set Up Guide

  2. Set Up Steps

  3. Functionality

  4. Monitoring Integration Activity

Setup Guide

Required Info

Before setting up the integration in MyBlackbird, you will need to obtain your specific integration information, as well as the version of MJFreeway you are using. Each MJFreeway account has specific keys that allow third party software platforms to share and receive select information. The following keys are needed to securely integrate the client’s MJFreeway account with Blackbird. Some of the fields listed below will be provided to the partner account on request and some will be given directly to the you upon request to an MJF account representative.

Configuration Fields



How to Find It


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

You will have one API key for all stores or locations under their account.

The API key is deposited into Blackbird’s partner account at your request.

Blackbird will verify the key and provide it to you.

Organization ID

Short number specific to the organization.

MJFreeway account representative will provide this to you upon request.

Client ID

Short number specific to the store or location. Your may have multiple Client IDs if there are multiple locations.

MJFreeway account representative will provide this to you upon request.

User ID

Short number that represents a user ID number.

MJFreeway account representative will provide this to you upon request.

Note on the Partner Account

Blackbird has a partner account with MJFreeway that was initially set up under Baker. Typically when requesting an API key from MJFreeway clients will need to provide the email address of the partner account so they can send the API Key to the correct account. The email used for the partner account is integrations+mjfw@trybaker.com.

The Partner account can be accessed at partners.mjfreeway.com using the email listed above. To obtain the password please ask the Director of Client Services or the Director of Data Management.

Setup Steps

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

Enter Authorization Info

Select MJ Platform from the Point of Sale section and enter the required integration credentials.


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

Product Sync - You should enable this if they plan to use the integration to facilitate an online menu. This sync will pull inventory from MJFreeway for all inventory that is in-stock and available online. 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 your MJFreeway account for fulfillment. This will remove the need to manually recreate customer profiles and orders in MJFreeway. Orders will be pushed directly to MJFreeway in real time as they are received.

Customer Push - You may want to enable this if you would like a customer profile automatically created in your POS after a customer has checked in using the Experiences App. This saves your staff time and eliminates any manual work needed to create a customer profile within your POS.

Customer Sync - You should enable this if they plan to use a loyalty program where customers earn points for completed orders. This sync pulls customer information from MJFreeway 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 they plan to use a loyalty program where customers earn points for completed orders. This sync pulls in order information for completed orders in MJFreeway. 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 MJFreeway and Blackbird is easy! Users can navigate to the Activity Log within your Integration Hub to see what information is being pulled from MJFreeway, 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?