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

When allow_upsert is 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.

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.

requests.method

string

CREATE, UPDATE, DELETE

For more details, see the API reference.

Limitations

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

Supported Fields

See the supported fields for the /{catalog_id}/items_batch endpoint: