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.
`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.

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