Skip to main content
POST
/
suppliers
Add a new supplier
curl --request POST \
  --url https://api.rechain.co/public/v1/suppliers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Supplier Name",
  "companyId": "123e4567-e89b-12d3-a456-426614174000",
  "moq": 500,
  "about": "Leading supplier of textiles with 20+ years of experience.",
  "componentsSourcing": false,
  "paymentTerms": "Net 30",
  "bulkLeadTime": "45 days",
  "incoterms": "FOB",
  "supplierType": "Manufacturer",
  "certifications": [
    "ISO 9001",
    "CE"
  ],
  "productCategoriesIds": [
    "123e4567-e89b-12d3-a456-426614174002",
    "123e4567-e89b-12d3-a456-426614174003"
  ]
}
'
{
  "name": "Supplier Name",
  "companyId": "123e4567-e89b-12d3-a456-426614174000",
  "moq": 500,
  "about": "Leading supplier of textiles with 20+ years of experience.",
  "componentsSourcing": false,
  "paymentTerms": "Net 30",
  "bulkLeadTime": "45 days",
  "incoterms": "FOB",
  "supplierType": "Manufacturer",
  "certifications": [
    "ISO 9001",
    "CE"
  ],
  "productCategoriesIds": [
    "123e4567-e89b-12d3-a456-426614174002",
    "123e4567-e89b-12d3-a456-426614174003"
  ],
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "id": 1,
  "skills": [
    "cutting",
    "sewing",
    "printing"
  ],
  "eori": "GB123456789000",
  "capabilities": [
    "mass production",
    "rapid prototyping"
  ],
  "locationsCount": 3,
  "country": [
    "USA",
    "China",
    "India"
  ],
  "products": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174004",
      "name": "Product Name",
      "description": "High-quality product for industrial use.",
      "productCategory": "Textiles"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a new supplier

​
name
string
required
Example:

"Supplier Name"

​
companyId
string<uuid>
required
Example:

"123e4567-e89b-12d3-a456-426614174000"

​
moq
integer
Example:

500

​
about
string
Example:

"Leading supplier of textiles with 20+ years of experience."

​
componentsSourcing
boolean
Example:

false

​
paymentTerms
string
Example:

"Net 30"

​
bulkLeadTime
string
Example:

"45 days"

​
incoterms
string
Example:

"FOB"

​
supplierType
string
Example:

"Manufacturer"

​
certifications
string[]
Example:
["ISO 9001", "CE"]
​
productCategoriesIds
string<uuid>[]
Example:
[
  "123e4567-e89b-12d3-a456-426614174002",
  "123e4567-e89b-12d3-a456-426614174003"
]

Response

Successful operation

​
uuid
string<uuid>
Example:

"123e4567-e89b-12d3-a456-426614174000"

​
id
integer
Example:

1

​
skills
string[]
Example:
["cutting", "sewing", "printing"]
​
eori
string
Example:

"GB123456789000"

​
capabilities
string[]
Example:
["mass production", "rapid prototyping"]
​
locationsCount
integer
Example:

3

​
country
string[]
Example:
["USA", "China", "India"]
​
products
object[]