---
title: "POST /{merchantId}/regions"
method: POST
path: "/{merchantId}/regions"
tags: ["regions"]
---

# POST /{merchantId}/regions

`POST /{merchantId}/regions`

Creates a region definition in your Merchant Center account.

## Path parameters

- `merchantId` string, required

## Query parameters

- `regionId` string

## Request body

- Region — Represents a geographic region that you can use as a target with both the `RegionalInventory` and `ShippingSettings` services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets.
  - `postalCodeArea` RegionPostalCodeArea — A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible via the account's `ShippingSettings.postalCodeGroups` resource.
    - `regionCode` string — Required. CLDR territory code or the country the postal code group applies to.
    - `postalCodes` RegionPostalCodeAreaPostalCodeRange[] — Required. A range of postal codes.
      - `begin` string — Required. A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: "94108", "9410*", "9*".
      - `end` string — Optional. A postal code or a pattern of the form prefix* denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin.
  - `regionalInventoryEligible` boolean — Output only. Indicates if the region is eligible to use in the Regional Inventory configuration.
  - `geotargetArea` RegionGeoTargetArea — A list of geotargets that defines the region area.
    - `geotargetCriteriaIds` string[] — Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (e.g., state).
  - `shippingEligible` boolean — Output only. Indicates if the region is eligible to use in the Shipping Services configuration.
  - `merchantId` string, int64 — Output only. Immutable. Merchant that owns the region.
  - `displayName` string — The display name of the region.
  - `regionId` string — Output only. Immutable. The ID uniquely identifying each region.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/content.md) · [All operations](https://skmtc.net/google/apis/content/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/content/revisions/1033388fc86f/schema)