Send orders or won deals to Kunads

For a shop on its own platform or any CRM. About an hour of work: one HTTPS request when an order is paid or a deal is won. The key comes from the account owner (Kunads → Connections → Custom shops, or Leads & CRMs → API).

Orders

curl -X POST https://app.kunads.ai/api/import \
  -H "Authorization: Bearer kimp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orders": [{
        "id": "1001",
        "date": "2026-10-05T14:30:00+03:00",
        "value": 59.80,
        "currency": "EUR",
        "status": "paid",
        "email": "buyer@example.com",
        "gclid": "Cj0KCQjw…",
        "utm_source": "google", "utm_medium": "cpc", "utm_campaign": "brand",
        "items": [{"sku": "PB-250", "name": "Peanut butter 250 g", "quantity": 2, "price": 13.80, "cost": 5.60}]
      }]}'

Won deals

curl -X POST https://app.kunads.ai/api/import \
  -H "Authorization: Bearer kimp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deals": [{
        "id": "D-501",
        "date": "2026-10-03",
        "value": 4500,
        "lead_date": "2026-09-12",
        "email": "client@example.com",
        "fbclid": "IwAR1x…",
        "utm_campaign": "leadform-autumn"
      }]}'

Zapier, Make or n8n — no code

  1. In Kunads: Connections → Leads & CRMs → API → Create import key. Copy the key (it starts with kimp_).
  2. Trigger: your CRM's “deal won” (or “deal updated” with a filter: status is won). For a shop: “new paid order”.
  3. Action: Zapier “Webhooks by Zapier → POST”, Make “HTTP → Make a request”, or an n8n “HTTP Request” node, to https://app.kunads.ai/api/import?kind=deal. For orders, leave out ?kind=deal.
  4. Header: Authorization: Bearer kimp_…. Body: JSON or form fields, one deal per call.
  5. Fields: id (the deal number), date (when it was won), value (what it is worth), email (the client's), and gclid or fbclid if your lead form saves them.
  6. Test it: Kunads answers {"ok": true, …}. The deal shows on the account the same day.

The email or the click id is what lets Kunads send each won deal back to Meta and Google, so they learn which people actually buy, not just who fills in a form.

Fields

FieldMeaning
idrequiredYour order or deal number. Sending the same id again updates it — refunds, status changes.
daterequiredWhen it was paid (orders) or won (deals). ISO 8601; a time zone is welcome.
valuerequiredWhat it is worth, excluding VAT and shipping if you can — that is what profit is worked out from.
currencyISO code. Left out, it is taken as your account's currency.
statusAnything containing cancel, refund, fail or lost is stored at 0.
email / customerLets Kunads count repeat customers. Kept only for that.
gclid, fbclidThe click id from the visit — the strongest link from a sale to the exact ad.
utm_source, utm_medium, utm_campaignHow the visitor arrived, when there is no click id.
lead_dateDeals: when the lead came in, so Kunads can measure time to close.
itemsOrders: lines with sku, name, quantity, price and cost — per-product margin.

Good to know