Ads and Commerce
Ads and Commerce
Resources

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.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon