LeafLink Integration Setup and Activation

Updated by NIr Malchy

Before we can go live, we need to enable webhooks in LeafLink and get some information to make the connection successful. A LeafLink user with admin access will need to begin this process.

To make your setup easy, use two tabs or two browser windows. Log in to Flourish on one, and log in to Leaflink on the other. Now, both platforms are in front of you, and you are ready to go!

We'll need to make sure that LeafLink is getting data from Flourish to integrate the two successfully. To start, we'll enable webhooks in LeafLink.

  1. In Leaflink, go to Settings > Company Information.
  2. Scroll down and locate the Developer access area.
  3. Check the Enable Developer Options box and the Enable Webhooks box.
    1. Checking the boxes activates the +Add Webhook button under Settings > Developer Options.
  4. Click Save.
  5. In Settings > Developer Options, click the + Add Webhook button.

If this tab is not available, you may need to enable viewing Developer Options in their user profile in LeafLink.
  1. Type Flourish in the Name field.
  2. Without closing your browser tab, open a new tab and log in to Flourish.
  3. Navigate to Settings > Integrations > LeafLink and click Configure.
  4. Click the Default Facility dropdown and select your default facility from the list.
    If you are routing orders from LeafLink to multiple Flourish facilities, select Match on Sales Rep.
    Learn more about Sales Rep Setup.
The Webhook URL changes between the settings of: "Match on Sales Rep" and "Default Facility" in Flourish. If you are switching between these two settings, make sure you have the correct one added to Leaflink.
  1. Click the copy button to copy the Webhook URL. Ensure it is the one you want.
Need some help with this step? Check out this quick video we made for you!
  1. Without closing your browser tab, return to LeafLink and paste the Webhook URL in the Url field.
  1. Check the New & Changed Orders box.
  2. Click Add Webhook.

Here is an example of what a complete webhook setup looks like:

Completing Webhook Setup in Flourish

We've completed setup in Leaflink, and in step 7 above, we started setting up the integration in Flourish. We'll complete the setup in Flourish so that orders can flow through from LeafLink.

We will need the following information from LeafLink to initiate the integration in Flourish Software:

  • API key
  • Company Webhook key
  • Company ID - populates automatically once the other fields have information in them.
  1. In LeafLink, navigate to Settings > Company Information > Developer Options.
  2. Click Generate Key under Company Webhook Key, then click OK to confirm.
  3. Click Generate Key under Your API Key.
  4. Make a note of the Company ID information.

Pasting Information from LeafLink into Flourish

  1. In Flourish, navigate to Settings > Integrations > LeafLink and click Configure.
  2. Verify your selection / select your Default Facility from the Default Facility dropdown.
    1. Inventory levels will be pulled from the default facility
    2. If you need to route your orders to more than one facility, select the Match on Sales Rep option.
      1. If you select "Match on Sales Rep", your inventory levels are pulled from all the facilities
  3. Copy your API Key from LeafLink and paste it into the API Key field.
  4. Copy the Company ID from LeafLink under the API section and paste it in the Company ID field.
License ID will automatically populate after you complete the steps above.
  1. Copy the Company Webhook Key from LeafLink and paste it into the Company Webhook Key field.
  2. Suppose you want to exclude a facility's inventory level from being synced from Flourish to Leaflink. In that case, it must be added to the Facilities to Exlcude from Inventory Sync from Flourish to Leaflink field:
    Exclude Facilities

Rules Setup

Configuration Video Overview

What are the Rules?

Rules define the nature of the integration in two ways:

Inventory/Item Sync Rules

  • Sync Inventory Levels to LeafLink will sync the Sellable quantity in Flourish as the Available quantity in LeafLink. This setup is useful when you want to manage your items in LeafLink, but you want Flourish to help manage the quantity of those items.
    • If you choose to Sync Inventory Levels to LeafLink,  and you have more than one facility (license), you must set the facility or facilities that updates that inventory level. Learn more here on how to set the inventory level updates.
  • Sync Items and Product Info to LeafLink will allow Flourish to create new items in LeafLink. This toggle is useful when you want Flourish to manage your items in LeafLink.

You can use one, both, or neither of these toggles in your LeafLink integration. To help you make the best decision, we'll explain a little more below.

As you know, Flourish sync the sellable quantity per item. When you have multiple facilities, Flourish calculates the sellable quantity from all your facilities to Leaflink. You can exclude facilities from this calculation by following the steps here.

Sync/Overwrite All

Enabling both toggles will allow you to create and manage item information in Flourish and push that information to LeafLink. You can still add brands, images, etc., in LeafLink directly.

If you choose to Sync Inventory Levels to LeafLink,  and you have more than one facility (license), you must set the facility or facilities that updates that inventory level. Learn more here on how to set the inventory level updates.

What item information does Flourish send to LeafLink?

  • Retail Display Name
  • Strain
  • UOM: Flourish (Each) = LeafLink = (Unit)
  • Sellable Quantity
  • Item Category
  • Price - As Wholesale Price
  • Description
  • Product Line
Sync Sellable Quantity

You can use the Sync Inventory Levels to LeafLink toggle if you have existing items in LeafLink and want to manage brands, pictures, etc. exclusively in LeafLink.

If you choose to Sync Inventory Levels to LeafLink,  and you have more than one facility (license), you must set the facility or facilities that updates that inventory level. Learn more here on how to set the inventory level updates.

What item information does Flourish send to LeafLink?

  • Retail Display Name
  • UOM: Flourish (Each) = LeafLink (Unit)
  • Sellable Quantity
This setup does not create a new item in LeafLink when you sync items to LeafLink in Flourish.

If you have a new item in Flourish and you want it to sync to LeafLink:

  1. Create the new item in LeafLink.
  2. Ensure the SKU matches exactly in both Flourish and LeafLink. Learn more here.
  3. Sync the item to LeafLink. Learn more here.
Sync Item Information

Enable the Sync Items and Product Info to LeafLink toggle when you want to sell products you may not have inventory for, and you marked ‘Unmanaged’ inventory in LeafLink.

What item information does Flourish send to LeafLink?

  • Retail Display Name
  • UOM: Flourish (Each) = LeafLink (Unit)
  • Item Category
  • Price - As Wholesale Price
  • Description
  • Product Line
This setup does not push sellable quantities to LeafLink. You will need to manage your inventory levels in LeafLink directly.

You can set the Status of Leaflink orders you want to sync into Flourish Software. Learn more here

Set inventory levels updates
  • When syncing to LeafLink, we count all the quantities across all facilities to ensure accurate numbers.
  • You can remove a facility or more from that calculation if you don't want to send their inventory numbers to Leaflink.
  • Learn here how to do that.

Save the Integration

After setting your rules, Save your work and enable the integration:

  1. Toggle Enabled to on.
  2. Click Save.

Congratulations! The integration between Flourish and LeafLink is active!

What's Next?

After the integration is on, it's time to sync your data and start working!

How did we do?