Upsert a Menu Item by External Identifier.

This operation facilitates the Indirect Management strategy for Menu Items.

• Use this operation with your internal ID as the reference.

• Weedmaps creates the item if it doesn't exist or updates it if it does.

• You receive the same response structure as Direct Management—containing all linked objects (brand, product, strain, tags, etc.).

Include Weedmaps Categories (required), Cannabinoids, Strains, Discovery Tags, and Terpenes to improve searchability and classification and overall Menu quality.

♻️ Keeping our Systems Synced

• The external_id should uniquely identify a Menu Item. It must not be tied to a "batch" or inventory shipment, as those change frequently.

• If the external_id changes (i.e., churns), Weedmaps will treat it as a new Menu Item. Even if it appears identical, it will lose all curated data—such as Brand links and Product attributes—previously applied through machine learning, manual merchandising, or the Weedmaps curation team.

• The external_product_id can be used to help caching efforts for Brand Product Linking for the Menu Item. This attribute should reflect your internal brand product identifier.

🚨 Important 🚨 A note on updating the product_id or brand_id:

Manual Brand linking performed by retailers or Weedmaps—whether through our mutual client or curation services—are intentional and high-value.

Do not overwrite these links, unless they have explicitly changed, and we urge you to send the replacement Weedmaps Brand identifier in its place.

Overwriting manually linked products undermines the integrity of curated content and significantly reduces the effectiveness of our joint efforts.

You should only send attributes that have been changed on your end.