Upsert products

Upload or update products for Lyro AI recommendations using batch processing.

Processing

  • Products are processed in an all-or-nothing manner: if any product in the batch is invalid, the entire request fails.
  • Processing is asynchronous; products become available after a short delay.
  • Maximum 100 products per request.

Data Management

  • A source becomes active after the first product upload.
  • Push-only model: Tidio does not pull or sync product data from your website automatically.
  • To update a product, re-send its complete data with the same id.
  • Product entries should represent specific variants (e.g., "Red T-shirt Size M", "Red T-shirt Size S" etc.).

Requirements

  • updated_at must follow ISO 8601 (e.g., "2023-06-01T10:00:00+00:00").
  • Field length limits:
    • url: 512 chars
    • image_url: 512 chars
    • title: 512 chars
    • vendor: 255 chars
    • product_type: 255 chars
    • sku: 255 chars
    • barcode: 255 chars
    • features (keys/values): 255 chars each

Usage Limits

  • Calling delete on a source in Tidio Panel, removes all its products and requires reupload. This can be done at most 2 times per 24 hours.
  • Deleting individual products over API does not affect this limit.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
products
array of objects
1 to 100
products
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json; version=1