> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Lab - Metafields and Product Reviews

Plan: Developer Foundations

Lesson 18 of 21 · 30 min

This lab activity will give you a chance to practice working with metafields and product reviews via the Catalog API. Each step will walk you through how to use all of the endpoints covered in the previous lesson.

### Prerequisites:

* BigCommerce store (sandbox or live)
* Basic knowledge of APIs
* REST client (Postman)
* Completion of all previous Catalog API labs

### In this lab, you will:

* Add a metafield to a product
* GET metafields by product ID
* Create a product review
* GET product reviews

## Add a Metafield to a Product

1. **Copy** and **paste** the request below into Postman

```http showLineNumbers={false}
https://api.bigcommerce.com/stores/{{store_hash}}/v3/catalog/products/:product_id/metafields
```

2. Enter the ID of the product created in previous lab for `product_id` in the Params tab
3. **Copy** and **paste** the code below into the Body section of Postman

```json showLineNumbers={false}
{
  "permission_set": "app_only",
  "namespace": "App Namespace",
  "key": "location_id",
  "value": "Shelf 3, Bin 5",
  "description": "Where products are located"
}
```

4. **Select** POST next to the request url
5. **Click** the Send button
6. **Observe** response and metafield added to product

## GET Metafields

1. **Copy** and **paste** the request below into Postman

```http showLineNumbers={false}
https://api.bigcommerce.com/stores/{{store_hash}}/v3/catalog/products/:product_id/metafields
```

2. Enter the ID of the product created in previous lab for `product_id` in the Params tab
3. **Select** GET next to the request url (if not already selected)
4. **Click** the Send button
5. **Observe** response

## Create a Product Review

1. **Copy** and **paste** the request below into Postman

```http showLineNumbers={false}
https://api.bigcommerce.com/stores/{{store_hash}}/v3/catalog/products/:product_id/reviews
```

2. Enter the ID of the product created in previous lab for `product_id` in the Params tab
3. **Copy** and **paste** the code below into the Body section of Postman

```json showLineNumbers={false}
{
  "title": "Great Product",
  "text": "This shirt is awesome!",
  "status": "approved",
  "rating": 5,
  "email": "janedoe@email.com",
  "name": "Jane Doe",
  "date_reviewed": "2019-03-21T19:37:13+00:00"
}
```

4. **Select** POST next to the request url
5. **Click** the Send button
6. **Observe** response and review added to product

## GET Product Reviews

1. **Copy** and **paste** the request below into Postman

```http showLineNumbers={false}
https://api.bigcommerce.com/stores/{{store_hash}}/v3/catalog/products/:product_id/reviews
```

2. **Enter** the ID of the product created in previous lab for `product_id` in the Params tab
3. **Select** GET next to the request url
4. **Click** the Send button
5. **Observe** response