Send Product Updates

To send product updates, use the /{catalog_id}/items_batch endpoint.

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

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

Parameter	Type	Description
`allow_upsert`	boolean	Optional: set this to `true` if you want to block update requests from creating new items. When set to `false`, update requests for items not existing in the catalog will not be completed. Otherwise, new items are created.
`item_type`	enum	The type of items in the request. Values: `DESTINATION`, `FLIGHT`, `HOME_LISTING`, `HOTEL`, `HOTEL_ROOM`, `PRODUCT_ITEM`, `VEHICLE`, `VEHICLE OFFER`.
`requests`	object	A JSON object containing all requests.
`requests.data`	object	A JSON object containing fields and values for a product. When the method is `CREATE`, this object must contain all the required fields for the specified `item_type`. 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`

For more details, see the API reference.

Limitations

The requests param can contain up to 5,000 items.
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.
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 supported fields for the /{catalog_id}/items_batch endpoint: