Skip to main content

Create distributor

POST /v1/distributor

Creates a new distributor record for the authenticated tenant. This endpoint validates the provided input, applies default values where applicable, and persists the new distributor to the system. The response returns the complete distributor object, including metadata such as creation and update timestamps.

Request Body​

{
    "name": "Distributor3",
    "active": true
  }

Response Example​

{
  "name": "Distributor1",
  "tenant": "tenant-id-1",
  "active": true,
  "address": {
    "line2": "",
    "street": "",
    "zip": "",
    "city": "",
    "country": "",
    "state": ""
  },
  "_id": "distributor-id-1",
  "created": "2025-10-21T15:56:18.355Z",
  "updated": "2025-10-21T15:56:18.355Z",
  "assignedProductsCount": 0
}