Custom Menu Items

Difference from Branded Items

Custom menu items are virtually the same as branded ones: The distinct difference is how they are created. With custom menu items, we don't need to first find the brand and the associated product in Weedmaps, but rather skip right to the POSTing of said item without any related product or brand.

📘

Required Relationships

When creating a new menu item, you must provide a menu relationship. This determines what listing this menu item belongs to. You must also provide at least one category so that your newly created item can be properly displayed.

NOTE: While an external_id is not required for Menu API, it is required for our Orders API. We use this ID to map a menu item into your POS on Order Insertion. An additional benefit you get when passing this ID is menu item uniqueness.

curl \
  --request POST \
  --url 'https://api-g.weedmaps.com/wm/v1/menu_items' \
  --header 'accept: application/json' \
  --header 'authorization: Bearer [ACCESS TOKEN HERE]' \
  --header 'content-type: application/json' \
  --data '{
    "type": "menu_item",
    "attributes": {
      "name": "Pineapple Express",
      "body": "The dopest dope you will ever smoke.",
      "genetics": "hybrid",
      "image_url": null,
      "published": true,
      "online_orderable": true,
      "external_id": "12345"
      "cannabinoids": {
        "cbd": {
          "percentage": 0.1
        },
        "thc": {
          "percentage": 0.1
        }
      },
      "variants": [
        {
          "price": {
            "amount": "17.06",
            "currency": "USD"
          },
          "weight": {
            "value": "1.0",
            "unit": "g"
          }
        }
      ]
    },
    "relationships": {
        "menu": {
            "data": {
                "type": "menu",
                "id": WMID_HERE
            }
        },
        "categories": {
            "data": [
                {
                    "type": "category",
                    "id": "a780af3d-bdfe-41ce-a782-20f2519fd7be"
                }
            ]
        }
    }
  }'

Why Use a Branded Product?

You might be wondering by now if branded/verified menu items are worth the trouble. What's the value of first attempting to find a product in Weedmaps before creating it? There are a number of reasons, but here are just a few:

  • Custom menu items cannot receive the verified symbol in the UI.
  • Custom menu items require the management of their images, descriptions, cannabinoids, and so on, whereas branded/verified items have these things managed automatically by the brands themselves.
  • In additional to managing the basic details of branded/verified items, brands themselves also manage their tags and categories. It would be up to you, the Integrator, to manage each of these for custom menu items.