Products.Add

Permissions

• User must be logged in with a valid bearer token.
• Returned or changed records are limited by the user permissions, team access, folder access, and account settings.

Action

• Creates a Products record or sends the requested data after validation.

Push Service

Pushes event products.created to users who should see this change.

Automation

Runs automation event products.created with the record id and submitted parameters after the action succeeds.

Special Instructions

• Product type (type) is a fixed dropdown — there is no separate ProductTypes.List API.
• Allowed type values (dashboard Type select): product = Physical Product; subscription = Subscription; service = Service; donation = Donation.
• Default when type is omitted: product.
• When type=subscription, use months, endless, and price_after like the dashboard subscription fields.
• Main category: cat_id from Categories.List (parent=0). Sub-category: sub_cat_id from Categories.List with parent=<cat_id>.
• Supplier: suppliers_id is a multi-select array like dashboard Create Product (select name="suppliers_id[]"). Stored as JSON e.g. ["267","170"]. Send array, suppliers_id[], JSON string, or a single id (wrapped to ["8"]). Default when omitted: []. Use Suppliers.List with for_product=1.
• Default warehouse: default_storage_id from Storage.List (storage.id — not storage_products.id).
• Main Image (dashboard Create Product image box): multipart/form-data field main_image as a file. Stored with the same FTP path as the dashboard: biz1upload/site/{owner}-{random}{time}.{ext}. Response main_image_url uses https://files.biz1.co.il/ (same as dashboard config file_url). Path aliases: site_logo_old, main_image_old.
• Optional second image: multipart sub_image (or path sub_image_old), same site folder.
• Existing JSON / x-www-form-urlencoded Products.Add calls without images still work unchanged.

Required Parameters

Optional Parameters

Authentication

Send the bearer token returned by Login in the request header.

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Products.Add",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "product_name": "Membership new product",
        "type": "product",
        "cat_id": "17963",
        "suppliers_id": [
            "8"
        ],
        "price": "99.00",
        "main_image": "@product.jpg"
    },
    "curl_multipart": "curl --location 'https:\/\/YOUR_HOST\/app\/Products.Add' \\\n--header 'Authorization: Bearer YOUR_TOKEN' \\\n--form 'product_name=Membership new product' \\\n--form 'type=product' \\\n--form 'price=99.00' \\\n--form 'main_image=@\/path\/to\/product.jpg'",
    "url_user": "https:\/\/{user}.bull36.com\/app\/Products.Add",
    "url_domain": "https:\/\/{domain}\/app\/Products.Add"
}

Endpoint

POST /app/Products.Add
POST https://{user}.bull36.com/app/Products.Add
POST https://{domain}/app/Products.Add

Sample Output

{
    "success": 1,
    "id": "123",
    "message": "Record added successfully.",
    "main_image": "biz1upload\/site\/14-ab12cd341712345678.jpg",
    "main_image_url": "https:\/\/files.biz1.co.il\/biz1upload\/site\/14-ab12cd341712345678.jpg",
    "sub_image": "",
    "sub_image_url": "",
    "automation_event": "products.created",
    "socket_event": "products.created"
}

JavaScript Example

const token = 'YOUR TOKEN';
// Without image (unchanged)
const body = new URLSearchParams({
  product_name: 'Membership new product',
  type: 'product',
  cat_id: '17963',
  price: '99.00'
});
const res = await fetch('/app/Products.Add', { method: 'POST', headers: { Authorization: 'Bearer ' + token }, body });
console.log(await res.json());

// With Main Image (multipart — same as dashboard Create Product)
const form = new FormData();
form.append('product_name', 'Membership new product');
form.append('type', 'product');
form.append('price', '99.00');
form.append('main_image', fileInput.files[0]);
const res2 = await fetch('/app/Products.Add', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + token },
  body: form
});
console.log(await res2.json());

Error Example

{
    "success": 0,
    "message": "No supported fields were sent."
}