---
title: "POST /{merchantId}/products/{productId}/regionalinventory"
method: POST
path: "/{merchantId}/products/{productId}/regionalinventory"
tags: ["regionalinventory"]
---

# POST /{merchantId}/products/{productId}/regionalinventory

`POST /{merchantId}/products/{productId}/regionalinventory`

## Request

- Base URL: `https://shoppingcontent.googleapis.com/content/v2.1`
- URL: `https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}/regionalinventory`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/content`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/content`
- TypeScript: <https://skmtc.dev/google/apis/content/docs/:merchantId/products/:productId/regionalinventory/post.ts> (a function with typed inputs; its response is checked against the schema)

Updates the regional inventory of a product in your Merchant Center account. If a regional inventory with the same region ID already exists, this method updates that entry.

## Path parameters

- `merchantId` string, required
- `productId` string, required

## Request body

- RegionalInventory: Regional inventory resource. contains the regional name and all attributes which are overridden for the specified region.
  - `price` Price
    - `value` string: The price represented as a number.
    - `currency` string: The currency of the price.
  - `regionId` string: The ID uniquely identifying each region.
  - `availability` string: The availability of the product.
  - `customAttributes` CustomAttribute[]: A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form.
    - `groupValues` CustomAttribute[]: Subattributes within this attribute group. Exactly one of value or groupValues must be provided.
    - `name` string: The name of the attribute. Underscores will be replaced by spaces upon insertion.
    - `value` string: The value of the attribute.
  - `kind` string: Identifies what kind of resource this is. Value: the fixed string "`content#regionalInventory`".
  - `salePriceEffectiveDate` string: A date range represented by a pair of ISO 8601 dates separated by a space, comma, or slash. Both dates might be specified as 'null' if undecided.
  - `salePrice` Price
    - `value` string: The price represented as a number.
    - `currency` string: The currency of the price.

## Response `200`

Successful response

- RegionalInventory: Regional inventory resource. contains the regional name and all attributes which are overridden for the specified region.
  - `price` Price
    - `value` string: The price represented as a number.
    - `currency` string: The currency of the price.
  - `regionId` string: The ID uniquely identifying each region.
  - `availability` string: The availability of the product.
  - `customAttributes` CustomAttribute[]: A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form.
    - `groupValues` CustomAttribute[]: Subattributes within this attribute group. Exactly one of value or groupValues must be provided.
    - `name` string: The name of the attribute. Underscores will be replaced by spaces upon insertion.
    - `value` string: The value of the attribute.
  - `kind` string: Identifies what kind of resource this is. Value: the fixed string "`content#regionalInventory`".
  - `salePriceEffectiveDate` string: A date range represented by a pair of ISO 8601 dates separated by a space, comma, or slash. Both dates might be specified as 'null' if undecided.
  - `salePrice` Price
    - `value` string: The price represented as a number.
    - `currency` string: The currency of the price.

---

[API](https://skmtc.dev/google/apis/content.md) - [All operations](https://skmtc.dev/google/apis/content/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/content/revisions/1033388fc86f?raw)