Ads and Commerce

Product Catalog Batch

Updated: Oct 17, 2025

Reading

You can’t perform this operation on this endpoint.

Creating

There should be no new integrations with this endpoint. The /items_batch endpoint should be used instead. If you are still making calls to the /batch endpoint please use this guide to migrate to /items_batch.

/{product_catalog_id}/batch

You can make a POST request to batch edge from the following paths:
When posting to this edge, a ProductItem will be created.

Parameters

Parameter Description
allow_upsert
boolean

Default value: true
Parameters specifying whether non existing items that are being updated should be inserted or should throw the error
requests
list<JSON object>
Array of JSON objects containing batch requests. Each batch request consists of retailer_id, method and data fields. 
`retailer_id` - retailer's ID for a
product.

`method` - an operation of a batch request, either `CREATE`, `UPDATE`
or `DELETE`.

`data` - JSON object containing fields and values for a product. See [Catalog Batch API](/documentation/ads-commerce/catalog/guides/manage-catalog-items/catalog-batch-api) to learn more the list of fields and values for the data object.
required

Return Type

This endpoint supports read-after-write and will read the node to which you POSTed. 
Struct  {
handles:  List  [string],
validation_status:  List  [ Struct  {
errors:  List  [ Struct  {
message: string,
}],
retailer_id: string,
warnings:  List  [ Struct  {
message: string,
}],
}],
}

Error Codes

Error Code Description
80014
There have been too many calls for the batch uploads to this catalog account. Wait a bit and try again. For more info, please refer to /docs/graph-api/overview/rate-limiting#catalog.
100
Invalid parameter
200
Permissions error
190
Invalid OAuth 2.0 Access Token

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.