Sync many products

POST https://app.sendapp.ai/api/products/bulk

Up to 1000 products per call, with the same fields as the single endpoint. The answer comes back at once (202): the rows are checked immediately and written shortly after, in blocks, without slowing the shop down. For a large catalogue make several calls in a row.

The answer carries an import_id to follow the progress.

One wrong row does not stop the others. Invalid rows are listed at once in errors, with their position in your list (index), the SKU and the reason.

Sending the whole catalogue again is safe and fast: identical products are counted as unchanged and are not rewritten.

import_key makes the call repeatable: if you send it again after a timeout with the same key (within 24 hours) you get the same import back, not a second one.

Limits: 3 imports in progress per account (beyond that, a 429 answer with Retry-After), 20 bulk calls per minute, request body at most 8 MB, 20,000 products per account.

Parameters

4 · 2 required

apikey required

Your API Key (alternatively: the X-API-Key header).

token optional

Account token. Required if you have more than one.

products required

List of products, with the same fields as the single endpoint. At most 1000 per call; each SKU only once.

import_key optional

Your own identifier for the call (max 80 characters), so it can be repeated without duplicates.

Need help with the integration? info@sendapp.live

Request

curl -X POST 'https://app.sendapp.ai/api/products/bulk' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "YOUR_ACCOUNT_TOKEN",
    "import_key": "feed-2026-09-18",
    "products": [
      { "sku": "MUG-01", "name": "Tazza", "price": 9, "stock": 120 },
      { "sku": "TSH-001", "price": 22.50 }
    ]
  }'

<?php
// Whole catalogue, 1000 products per call, then follow each import.
foreach (array_chunk($catalogue, 1000) as $i => $chunk) {
    $ch = curl_init('https://app.sendapp.ai/api/products/bulk');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode([
            'token'      => 'YOUR_ACCOUNT_TOKEN',
            'import_key' => 'feed-' . date('Y-m-d') . '-' . $i,
            'products'   => $chunk,
        ]),
    ]);
    $res = json_decode(curl_exec($ch), true);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($code === 429) { sleep(30); /* send this chunk again */ }
}

const res = await fetch('https://app.sendapp.ai/api/products/bulk', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    token: 'YOUR_ACCOUNT_TOKEN',
    products: catalogue.slice(0, 1000),
  }),
});
const { import_id } = await res.json();

Response

{
  "status": "success",
  "accepted": 1,
  "rejected": 1,
  "import_id": "imp_eggsipzvalu6xlkqjfecphki",
  "state": "queued",
  "total": 1,
  "processed": 0,
  "created": 0,
  "updated": 0,
  "unchanged": 0,
  "failed": 1,
  "images": { "status": "none", "total": 0, "done": 0, "failed": 0 },
  "errors": [
    { "index": 1, "sku": "MUG-02", "error": "The price field must be a number." }
  ],
  "started_at": null,
  "finished_at": null,
  "created_at": "2026-09-18T09:02:11+00:00"
}

{
  "status": "error",
  "message": "There are already 3 imports in progress for this account: wait for one to finish (check GET /api/products/imports/{import_id})."
}