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

# POST /{merchantId}/collections

`POST /{merchantId}/collections`

Uploads a collection to your Merchant Center account. If a collection with the same collectionId already exists, this method updates that entry. In each update, the collection is completely replaced by the fields in the body of the update request.

## Path parameters

- `merchantId` string, required

## Request body

- Collection — The collection message.
  - `headline` string[] — Your collection's name. [headline attribute](https://support.google.com/merchants/answer/9673580)
  - `customLabel4` string — Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns.
  - `customLabel2` string — Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns.
  - `imageLink` string[] — The URL of a collection’s image. [image_link attribute](https://support.google.com/merchants/answer/9703236)
  - `customLabel1` string — Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns.
  - `customLabel0` string — Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns. [Custom label](https://support.google.com/merchants/answer/9674217)
  - `mobileLink` string — A collection’s mobile-optimized landing page when you have a different URL for mobile and desktop traffic. [mobile_link attribute](https://support.google.com/merchants/answer/9646123)
  - `featuredProduct` CollectionFeaturedProduct[] — This identifies one or more products associated with the collection. Used as a lookup to the corresponding product ID in your product feeds. Provide a maximum of 100 featuredProduct (for collections). Provide up to 10 featuredProduct (for Shoppable Images only) with ID and X and Y coordinates. [featured_product attribute](https://support.google.com/merchants/answer/9703736)
    - `x` number, float — Required. X-coordinate of the product callout on the Shoppable Image.
    - `y` number, float — Required. Y-coordinate of the product callout on the Shoppable Image.
    - `offerId` string — The unique identifier for the product item.
  - `link` string — A collection’s landing page. URL directly linking to your collection's page on your website. [link attribute](https://support.google.com/merchants/answer/9673983)
  - `id` string — Required. The REST ID of the collection. Content API methods that operate on collections take this as their collectionId parameter. The REST ID for a collection is of the form collectionId. [id attribute](https://support.google.com/merchants/answer/9649290)
  - `productCountry` string — [product_country attribute](https://support.google.com/merchants/answer/9674155)
  - `customLabel3` string — Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns.
  - `language` string — The language of a collection and the language of any featured products linked to the collection. [language attribute](https://support.google.com/merchants/answer/9673781)

## 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)