Import a listings catalog
Creates a listings catalog from CSV text or a public Google Sheet link, using the column mapping you confirmed (see the preview mapping endpoint), and queues the import. Returns 201 with the source, row counts and values it couldn’t map. Names are unique per workspace.
Scopes: knowledge:write
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.
255The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Body
1 - 120An uploaded CSV, as text.
200000A Google Sheet anyone with the link can view.
20002003002001 <= x <= 720