API to bulk edit products and their associated prices (max 30 entities)

http
POST https://services.leadconnectorhq.com/products/bulk-update/edit

Authorization

NameTypeRequiredExampleDescription
AuthorizationstringYesBearer token generated from the Leadway portal. See Authentication.
VersionstringYes2021-07-28API version.

Body

NameTypeRequiredExampleDescription
altIdstringYes6578278e879ad2646715ba9cAccount Id or Agency Id
altTypestringYesPossible values: 'account'
  • products (object[], required): Array of products to update. Note: The total count includes all prices within each product.

    • _id (string, required): Product ID Example: 64a1b2c3d4e5f67890123456

    • name (string): Product name Example: Premium Product

    • description (string): Product description Example: A high-quality premium product with excellent features and durability

    • image (string): Product image Example: https://example.com/product-image.jpg

    • availableInStore (boolean): Product availability in store Example: True

    • prices (object[]): Array of price variants for the product

      • _id (string, required): Price ID Example: 64a1b2c3d4e5f67890123456

      • name (string): Price name Example: Standard Plan

      • amount (number): Price amount Example: 99.99

      • currency (string): Price currency Example: USD

      • compareAtPrice (number): Compare at price Example: 129.99

      • availableQuantity (number): Available quantity Example: 100

      • trackInventory (boolean): Track inventory Example: True

      • allowOutOfStockPurchases (boolean): Allow out of stock purchases Example: False

      • sku (string): SKU Example: SKU-001

      • trialPeriod (number): Trial period in days Example: 7

      • totalCycles (number): Total billing cycles Example: 12

      • setupFee (number): Setup fee Example: 25

      • shippingOptions (object): Shipping options

      • recurring (object): Recurring details

    • collectionIds (string[]): Collection IDs

    • isLabelEnabled (boolean): Enable product label Example: True

    • isTaxesEnabled (boolean): Enable taxes Example: True

    • seo (object): SEO metadata for the product

    • slug (string): Product URL slug Example: premium-product

    • automaticTaxCategoryId (string): Automatic tax category ID Example: 64a1b2c3d4e5f67890123460

    • taxInclusive (boolean): Tax inclusive pricing Example: False

    • taxes (object[]): Product taxes

    • medias (object[]): Product media

    • label (object): Product label

Responses

201 - Products and prices updated successfully
  • message (string, required): Success message Example: Products updated successfully

  • status (boolean, required): Operation status Example: True

  • updatedCount (number, required): Number of products updated Example: 5

json
{
  "message": "Products updated successfully",
  "status": true,
  "updatedCount": 5
}
400 - Bad Request
json
{}
401 - Unauthorized
json
{}
422 - Unprocessable Entity
json
{}

Example

curl -X POST 'https://services.leadconnectorhq.com/products/bulk-update/edit' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
  "altId": "6578278e879ad2646715ba9c",
  "altType": "account",
  "products": [
    {
      "_id": "64a1b2c3d4e5f67890123456",
      "name": "Premium Product",
      "description": "A high-quality premium product with excellent features and durability",
      "image": "https://example.com/product-image.jpg",
      "availableInStore": true,
      "prices": [
        {}
      ],
      "collectionIds": [
        "64a1b2c3d4e5f67890123458",
        "64a1b2c3d4e5f67890123459"
      ],
      "isLabelEnabled": true,
      "isTaxesEnabled": true,
      "slug": "premium-product",
      "automaticTaxCategoryId": "64a1b2c3d4e5f67890123460",
      "taxInclusive": false,
      "taxes": [
        {}
      ],
      "medias": [
        {}
      ],
      "label": {}
    }
  ]
}'

Last updated October 26, 2026

Was this page helpful?