---
title: "Create supplier"
method: POST
path: "/consumers/{consumer_id}/accounting/suppliers"
tags: ["Accounting", "Suppliers"]
---

# Create supplier

`POST /consumers/{consumer_id}/accounting/suppliers`

Create a new supplier

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `folder_id` string, nullable
- `force_merge` string, nullable

## Request body

- SupplierItemIn
  - `external_reference` string, nullable — External identifier used to link the supplier in the accounting system with the corresponding supplier reference in your own system.
  - `first_name` string, nullable — Only used when the supplier is an individual (is_company=false). Indicates the first name of the supplier.
  - `last_name` string, nullable — Only used when the supplier is an individual (is_company=false). Indicates the last name of the supplier.
  - `name` string, required — Full name or legal name of the supplier (individual or company). This is the name that will be displayed in the accounting software.
  - `function` string, nullable — Only used when the supplier is an individual (is_company=false). Indicates the function of the supplier.
  - `is_company` boolean, nullable — Indicates if the supplier is an individual or a company.
  - `company_id` string, nullable — Only used when the supplier is an individual (is_company=false). Indicates the id of the company linked to the supplier.
  - `phone` string, nullable — Phone number of the supplier.
  - `mobile` string, nullable — Mobile phone number of the supplier.
  - `email` string, nullable — Email address of the supplier.
  - `language` string, nullable — Language of the supplier. Format: ISO 639-1 codes.
  - `internal_notes` string, nullable — Internal notes about the supplier.
  - `website` string, nullable — Website of the supplier.
  - `vat` string, nullable — VAT number of the supplier.
  - `company_number` string, nullable — National identification number of the company.
  - `iban` string, nullable — IBAN account number of the supplier.
  - `bank_account` string, nullable — Bank account number of the supplier.
  - `currency` string, nullable — Indicates the currency of the supplier (e.g., EUR).
  - `active` boolean, nullable — Indicates if the supplier is active.
  - `addresses` AddressItemIn[], required — List of addresses associated with the supplier.
    - `address_type` 'main' | 'delivery' | 'invoice', required
    - `name` string, nullable
    - `number` string, nullable
    - `box` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `email` string, nullable
    - `street` string, required
    - `city` string, required
    - `postal_code` string, required
    - `country` string, required — Format: ISO 3166-1 codes.
  - `account_number` string, nullable — Number of ledger account assigned to the supplier in the accounting system as it will appear in the official accounting export file (FEC, SIE, iXBRL, etc.). This is typically the ledger account used for posting payables. In some systems, each supplier has a dedicated account; in others, a shared control account is used and supplier balances are tracked in a subledger.

## Response `200`

Successful Response

- SupplierItemOut
  - `external_reference` string, nullable — External identifier used to link the supplier in the accounting system with the corresponding supplier reference in your own system.
  - `first_name` string, nullable — Only used when the supplier is an individual (is_company=false). Indicates the first name of the supplier.
  - `last_name` string, nullable — Only used when the supplier is an individual (is_company=false). Indicates the last name of the supplier.
  - `name` string, nullable — Full name or legal name of the supplier (individual or company). This is the name displayed in the accounting software.
  - `function` string, nullable — Only used when the supplier is an individual (is_company=false). Indicates the function of the supplier.
  - `is_company` boolean, nullable — Indicates if the supplier is an individual or a company.
  - `company_id` string, nullable — Only used when the supplier is an individual (is_company=false). Indicates the id of the company linked to the supplier.
  - `phone` string, nullable — Phone number of the supplier.
  - `mobile` string, nullable — Mobile phone number of the supplier.
  - `email` string, nullable — Email address of the supplier.
  - `language` string, nullable — Language of the supplier. Format: ISO 639-1 codes.
  - `internal_notes` string, nullable — Internal notes about the supplier.
  - `website` string, nullable — Website of the supplier.
  - `vat` string, nullable — VAT number of the supplier.
  - `company_number` string, nullable — National identification number of the company.
  - `iban` string, nullable — IBAN account number of the supplier. DEPRECATED see bank_accounts
  - `bank_account` string, nullable — Bank account number of the supplier. DEPRECATED see bank_accounts
  - `currency` string, nullable — Indicates the currency of the supplier (e.g., EUR).
  - `active` boolean, nullable — Indicates if the supplier is active.
  - `account_number` string, nullable — Ledger account number assigned to the supplier in the accounting system as it will appear in the official accounting export file (FEC, SIE, iXBRL, etc.).
  - `id` string, nullable — Id of the supplier in the accounting software. This is the unique identifier used to reference the supplier in the system.
  - `last_updated_on` string, date-time, nullable — The last time the supplier has been updated.
  - `addresses` AddressItemOut[], nullable — List of addresses associated with the supplier.
    - `address_type` 'main' | 'delivery' | 'invoice', required
    - `name` string, nullable
    - `number` string, nullable
    - `box` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `email` string, nullable
    - `street` string, nullable
    - `city` string, nullable
    - `postal_code` string, nullable
    - `country` string, nullable — Format: ISO 3166-1 codes.
  - `third_party_account` string, nullable — Third party account number/code representing the client in the accounting software.
  - `bank_accounts` BankAccountsItem[], nullable — List of bank accounts information associated with the suppliers.
    - `is_primary` boolean, nullable — Indicates whether this is the default bank account for this third-party. Only one bank account per third-party can have is_primary set to true. Defaults to true.
    - `currency` string, nullable — Indicates the currency of the bank account (e.g., EUR).
    - `iban` string, nullable — International Bank Account Number (ISO 13616). Present for countries in the IBAN scheme (e.g., France, Germany, United Kingdom). null for countries that do not participate in the IBAN scheme (e.g., US, Canada, Australia).
    - `bic_swift` string, nullable — Bank Identifier Code (ISO 9362), also known as SWIFT code. 8 or 11 characters. Optional for domestic payments, but required for international wire transfers.
    - `account_number` string, nullable — Local bank account number. Used when the country does not participate in the IBAN scheme (e.g., US, CA, AU). Always paired with a routing_code.
    - `routing_code` RoutingCodeItem
      - `type` 'unknown' | 'ach' | 'sort_code' | 'bsb' | 'transit' | 'ifsc' | 'clabe'
      - `value` string, nullable — The raw routing code value, without spaces or dashes.

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.net/chift/apis/chift-api.md) · [All operations](https://skmtc.net/chift/apis/chift-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chift/chift-api/versions/b5f1214a482a/schema)