GuidesAPI EndpointsChangelog
Log In
API Endpoints

Create a Menu Item

This operation will create a Menu Item for a specific Menu identified in the path parameter.

⚠️ Always store the id from the creation response for future updates and deletions.

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required
Body Params
category_ids
array of int32s
required

The primary identifier for a root Weedmaps Category and all Sub-Category identifiers.

category_ids*
integer

The primary identifier for a Weedmaps Brand.

string

The custom brand name for this Menu Item, which will be used to autolink to a matching brand on Weedmaps (if applicable); cannot be combined with brand_id

cannabinoids
array of objects

List of Cannabinoid Measurements. You can provide the id or slug as an identifier.

cannabinoids
int32 | null

An Integer timestamp of last image update. This can be updated to force a re-download of a previously cached image.

integer

The primary identifier for a Weedmaps Brand Product. If this Menu Item is linked with a valid product_id it will override *some Menu Item attributes with the Brand's official details for their Product.

sale
object
deprecated

The Sale Price to apply to the Menu Item. This will be displayed on the Menu Item and display the price of the Menu Item as a ~strike-through~ price. The Sale Price will override the Price through Weedmaps Orders flow.

integer

A Weedmaps Strain identifier. Mutually exclusive with the strain_name field.

string

If you do not have a Weedmaps Strain identifier, this additional property will attempt to match to a Strain in the Weedmaps Taxonomy. Providing a Weedmaps strain_id is the preferred method and will provide the best results for Menu Item and overall Menu quality.

tag_ids
array of objects

List of Weedmaps Discovery Tag identifiers. Mutually exclusive with the field tag_names.

tag_ids
tag_names
array of strings

If you do not have Weedmaps Discovery Tag identifiers, this additional property will attempt to match to Discovery Tags in the Weedmaps Taxonomy. Providing Weedmaps tag_ids is the preferred method and will provide the best results for Menu Item and overall Menu quality. Mutually exclusive with the field tag_ids.

tag_names
terpenes
array of objects

List of Terpenes Measurements. You can provide an id or slug as the identifier.

terpenes
variants
array of objects
variants
string

The description for this Menu Item that is displayed on Weedmaps.

string
required

This field represents your internal retail client's purchasable item's identifier.

string | null

This field represents your the Brand Product identifier that is linked to your inventory item.

string | null
enum

The genetics classification of this resource

Allowed:
string

Image displayed for this Resource.

string
required

The name that is displayed on a Weedmaps.

boolean

This field controls the public visibility of on Weedmaps.

compliance
object | null
deprecated

The compliance information for this item.

float
≥ 1
deprecated

This represents the quantity used through the Weedmaps Order flow. It defaults to 1.0.

int32
≥ 1
deprecated

The amount of available for purchase

int32
≥ 1
deprecated

Items per pack for this item.

string | null
deprecated

The license requirements to purchase Menu Item.

boolean
deprecated

This determines if this Item can be added to a cart and go through a Weedmaps Order flow.

price
object
deprecated
Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json