---
title: "Creates a new Supplier."
method: POST
path: "/v1/suppliers"
tags: ["Suppliers"]
---

# Creates a new Supplier.

`POST /v1/suppliers`

## Request body

- SupplierDto
  - `postponedAccounting` boolean
  - `internationalServices` boolean
  - `purchaseImporterSetting` PurchaseImporterSettingDto
    - `nominal` integer
    - `analysisCategory` integer
    - `vatCategory` string
  - `id` integer
  - `ownerTypeId` integer
  - `code` string
  - `accountName` string
  - `accountNumber` string
  - `authCode` string
  - `contact` string
  - `eFTReference` string
  - `email` string
  - `fax` string
  - `mobile` string
  - `name` string
  - `ourCode` string
  - `phone` string
  - `vatReg` string
  - `timestamp` string, byte
  - `address` string[]
  - `additionalEmails` string[]
  - `bank` EFTBankDto
    - `id` integer
    - `name` string
    - `branch` string
    - `sortCode` string
  - `vatAnalysisTypeId` integer
  - `vatType` integer
  - `ledgerBalance` number, double
  - `openingBalance` OwnerOpeningBalanceInPeriodsDto
    - `currentMonth` number, double
    - `oneMonthOld` number, double
    - `twoMonthsOld` number, double
    - `threeMonthsOld` number, double
  - `openingBalances` OwnerOpeningBalanceDto[]
    - `id` integer
    - `entryDate` string, date-time
    - `procDate` string, date-time
    - `reference` string
    - `timestamp` string, byte
    - `total` number, double
    - `totalVAT` number, double
    - `unpaid` number, double
    - `vatEntries` OwnerOpeningBalanceVatEntryDto[]
      - `vatRateId` integer
      - `amount` number, double
    - `isChanged` boolean
  - `businessIdentifierCode` string
  - `internationalBankAccountNumber` string
  - `salesRepId` integer

## Response `200`

OK

- object

---

[API](https://skmtc.net/bigredcloud/apis/big-red-cloud-api.md) · [All operations](https://skmtc.net/bigredcloud/apis/big-red-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigredcloud/big-red-cloud-api/versions/1324a5ec638a/schema)