Skip to main content

Leafly Integration

Sync your Pointless POS product catalog to Leafly and receive Leafly orders directly into your POS.

What This Integration Does​

The Leafly integration handles two things:

  • Menu Publishing — Syncs your local product catalog to Leafly with pricing, inventory counts, strain details, and product images.
  • Order Intake — Receives orders placed on Leafly and routes them into your POS order queue.

Getting Started​

Before enabling the integration, make sure you have the following ready:

  • An active Leafly account with API access
  • Your Leafly menu integration key
  • Your Leafly OAuth credentials (client ID and client secret)
  • Product images uploaded to your POS catalog

Enabling the Integration​

  1. Navigate to Settings > Integrations > Leafly in your POS admin panel.
  2. Enter your Leafly API credentials:
    • Menu Integration Key
    • OAuth Client ID
    • OAuth Client Secret
  3. Select whether you're using the Leafly sandbox or production environment.
  4. Save your settings.

Once saved, your POS will automatically fetch and cache an access token for communicating with Leafly. The token refreshes automatically when it expires.

Publishing Your Menu​

After enabling the integration, your product catalog can be synced to Leafly as menu listings.

How It Works​

When you publish, your POS:

  1. Scans your catalog for products that meet the minimum inventory threshold.
  2. Matches each product to its METRC inventory record to pull strain name, THC/CBD values, brand, and images.
  3. Maps each product into a Leafly listing with the appropriate category (flower, pre-roll, edible, concentrate, etc.).
  4. Sends the listings to Leafly with current pricing and stock levels.

Pricing​

  • Prices from your inventory take priority over catalog menu prices.
  • Items sold by the "each" are published with a single price.
  • Items sold by weight (e.g., grams) are published with tiered pricing — such as 1g, 3.5g, and so on — based on your price tiers.

Minimum Inventory Threshold​

Products only publish to Leafly when their inventory is above a minimum threshold. You can configure these thresholds in your transaction settings:

Product TypeDefault Minimum
Each (individual items)5 units
Grams (weighted items)10 units

When a product's inventory falls below the threshold, it will automatically be unpublished from Leafly on the next sync.

Publishing Actions​

You have several options for publishing your menu:

ActionWhat It Does
Publish Full MenuPublishes all eligible products from your catalog
Publish by TypePublishes a specific product type (e.g., "Each" items, "Grams" items, or "Buds")
Incremental SyncPublishes products whose inventory crossed above the threshold and unpublishes products that fell below
Reset MenuClears all published listings from Leafly, then republishes from scratch
Unpublish ItemsRemoves specific products from your Leafly menu
Publish SelectedPublishes a specific list of products you choose

Full publish is available to all staff. Most other actions require admin or manager access.

Receiving Orders from Leafly​

When a customer places an order through Leafly, the order is sent to your POS automatically via webhook.

Order Events​

Your POS responds to the following Leafly events:

  • Order Created — A new order is placed
  • Order Submitted — The customer has finalized their order
  • Order Activated — The order is active and ready to fulfill
  • Order Status Change — The order status has been updated
  • Order Preview — A preview of the order before checkout
  • Order Cancelled — The customer has cancelled the order
  • Order Deactivated — The order is no longer active

Order Validation​

When a Leafly order arrives, your POS validates each item in the order:

  1. Checks that the product is still available in your catalog.
  2. Confirms enough inventory is on hand to fulfill the quantity ordered.
  3. Verifies the price on Leafly matches your current retail price.

If any item fails validation — such as being out of stock or having a mismatched price — the order will flag for your review.

Managing Your Access Token​

Your POS automatically handles the OAuth token needed to communicate with Leafly. The token is cached and refreshed when it expires.

If you need to clear the cached token:

  1. Go to Settings > Integrations > Leafly.
  2. Click Clear Token.
  3. The next publish or sync action will automatically fetch a fresh token.

You can also view the current token status on this same settings page.

Troubleshooting​

ProblemWhat to Check
Products aren't appearing on LeaflyVerify inventory is above the minimum threshold. Run a full publish.
Prices don't matchCheck that your inventory-level pricing is set correctly. Inventory prices override catalog menu prices.
Token errorsClear the cached token and try again. Verify your OAuth credentials in settings.
Orders not arrivingConfirm your Leafly account has webhooks configured to point to your POS. Check with support if needed.
Images not showingMake sure product images are uploaded and accessible. They should be stored in your AWS S3 bucket.
Strain or brand info missingEnsure the product is linked to a METRC inventory assignment with strain and facility data.

Security​

  • Your API credentials and OAuth tokens are stored securely in your POS settings.
  • Never share your Leafly client secret or API key.
  • Keep your webhook endpoint private — do not expose it publicly outside of Leafly's configuration.

Need Help?​

If you're having trouble with the Leafly integration, contact support with the following information:

  • Your business name and account ID
  • Screenshots of any error messages
  • Whether the issue is with publishing, order intake, or both