Skip to main content

Klar API — Introduction

Import orders, returns, and costs from any custom system into Klar — without a native integration.

Written by Michael Stenger

Klar natively supports a wide range of data sources for importing your order and marketing data. If your data source isn't on that list — for example because you're running a custom shop system, a headless setup, or managing orders through an ERP — you can use the Klar API to push your order and returns data directly into Klar.

The API is RESTful and designed to be straightforward to integrate. Once your data is flowing in, it appears in Klar's profitability and attribution reports just like data from any native integration — giving you the same DB1/DB2 breakdown, ROAS, and CAC calculations regardless of your tech stack.

Using the API requires an active Klar account.

First: authenticate

All API endpoints require authentication. Start here: Authentication


Then: choose your import path

Everything in one object? Use the Orders endpoint to import orders, COGS, logistics costs, and refunds all at once.

Importing data from separate systems? You can use each endpoint independently:

  • COGS — e.g. from an external ERP

  • Logistics Costs — e.g. from your 3PL

  • Refunds — e.g. if your shop system handles orders but not returns

This is especially useful when your shop is already connected to Klar but one part of your data (returns, COGS, logistics costs) lives in a separate system.

Did this answer your question?