Skip to main content

Create Supplier Product

POST 
/api/supplier-products

Creates a new supplier product relationship (a product sold by a specific supplier). Authentication: Requires Bearer token.

Required scope: suppliers:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Fields:

  • supplier_id (required): Supplier ID (must exist in suppliers table)
  • product_id (required): Product ID (must be unique per supplier; must exist in products table)
  • supplier_sku (nullable, max:255): Supplier's own SKU. The same supplier SKU may be used on several products of this supplier
  • leadtime (nullable, integer): Lead time in days
  • minimum_order_quantity (nullable, numeric): Minimum order quantity (max 999,999)
  • target_stock_days (nullable, integer): Target stock days (1-365)
  • is_default (boolean): Whether this is the default supplier for this product
  • default_tax_rate_id (nullable): Tax rate ID for this supplier product

Requires permission: suppliers.update

Request​

Responses​

Created

Response Headers
    Content-Type