Skip to content

REST connections

Pull products from your own REST API with simple authentication, map the fields once and refresh on a schedule.

A connection in the Connections tab pulls products from a REST endpoint you control. It is the honest first version of connecting a live API: generic REST, mapped once and refreshed on a schedule.

Setting up a connection

  • Name and base URL for the API.
  • Authentication: bearer token, basic auth or a custom header. Credentials are stored encrypted.
  • Endpoint path and a pagination preset (page and limit, a cursor field or offset).
  • A test fetch button that shows the first item returned as JSON so you can confirm the shape.
  • A field map from JSON path to schema field, with the same synonym based automatic mapping used on import.

Records are upserted by their external id, so re-running a connection updates existing products rather than duplicating them. Choose a manual or daily schedule. Each connection has a status card showing the last run, the number of items synced and any errors. A single sync fetches at most 200 pages, a guard against pagination loops in the source API.

Provider specific presets are on the roadmap, not pretend buttons. Today every connection is configured as generic REST.