---
title: "Product Tag Add"
method: POST
path: "/product"
tags: ["Product Tags"]
---

# Product Tag Add

`POST /product`

## Request

- Base URL: `https://api.folksonomy.openfoodfacts.org`
- URL: `https://api.folksonomy.openfoodfacts.org/product`
- Auth: OAuth 2
  - Password
  - Token URL: `auth`

Create a new product tag (version=1)

- **product**: which product
- **k**: which key for the tag
- **v**: which value to set for the tag
- **version**: none or empty or 1
- **owner**: none or empty for public tags, or your own user_id

Be aware it's not possible to create the same tag twice. Though, you can update
a tag and add multiple values the way you want (don't forget to document how); comma
separated list is a good option.

## Request body

- ProductTag
  - `product` string, required
  - `k` string, required
  - `v` string, required
  - `owner` string
  - `version` integer
  - `editor` string, nullable
  - `last_edit` string, date-time, nullable
  - `comment` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/openfoodfacts/apis/open-food-facts-folksonomy-rest-api.md) - [All operations](https://skmtc.dev/openfoodfacts/apis/open-food-facts-folksonomy-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openfoodfacts/apis/open-food-facts-folksonomy-rest-api/revisions/ecf11a0df87a?raw)