Send Item Updates

To send item updates, use the /{catalog_id}/batch endpoint.

To create, update, or delete items in your catalog, make an HTTP POST call to:

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch?requests=<REQUESTS>

Parameters

The parameter names for /{catalog_id}/batch and /{catalog_id}/items_batch may appear to be similar, but they are distinctly different.

We recommend using /{catalog_id}/items_batch API, which supports more use cases and is actively maintained.

Parameter	Type	Description
`allow_upsert`	boolean	When `allow_upsert` is `false`, update requests for items not existing in the catalog will not be completed. Otherwise, new items are created.
`requests`	object	A JSON object containing all requests.
`requests.data`	object	A JSON object containing fields and values for an item. When the method is `CREATE`, this object must contain all the required fields. When the method is `UPDATE`, it can contain any fields. Note: See the Supported Fields that can be passed.
`requests.method`	string	`CREATE`, `UPDATE`, `DELETE`
`requests.retailer_id`	string	The advertiser-supplied `id` of an item; not the FBID.

The UPDATE method can also be used to create items if they don't already exist.

For more details, see the API reference.

The requests param can contain up to 5,000 updates.
For each catalog, you can make a number of calls per hour defined by the Catalog Batch business use case rate limit formula. If that's not sufficient, please contact us.
The batch size limit is 5000.
Error code 1 with message "Please reduce the amount of data you're asking for, then retry your request" indicates that the size of the data (in bytes) received in API request is too large. To fix this issue, please reduce the number of items in the batch and try again. This will ensure that the request is within the acceptable size limits and can be processed successfully.

See the list of supported fields for the /{catalog_id}/batch endpoint.