---
title: "[Preview] Create a supplier"
method: POST
path: "/companies/{companyId}/suppliers"
tags: ["suppliers"]
---

# [Preview] Create a supplier

`POST /companies/{companyId}/suppliers`

Creates a new supplier for the company.

**Scope:** `suppliers:write`

## Request body

- Supplier
  - `id` string, uuid
  - `name` string, required
  - `orgNumber` string
  - `vatNumber` string
  - `currency` string — ISO 4217 currency code. Defaults to SEK if not provided. Sets the currency for the supplier, which determines the currency used when creating supplier invoices. When a non-SEK currency is set, exchange rates are automatically calculated to determine the correct SEK amount — no manual exchange rate lookup is needed. Allowed values depend on whether the company has a Bokio Business Account (BBA): **With Bokio Business Account:** `SEK`, `EUR`, `NOK`, `USD`, `DKK`, `GBP`, `PLN`, `RON`, `CZK`, `HUF`, `ISK`, `CHF` Note: For companies with a Bokio Business Account, only currencies supported by BBA are available. For supplier invoices that cannot be paid via BBA, the currency must be set to `SEK` and exchange rates must be handled manually. **Without Bokio Business Account:** `SEK`, `GBP`, `EUR`, `USD`, `NOK`, `DKK`, `AUD`, `BRL`, `CAD`, `CHF`, `CNY`, `CZK`, `HKD`, `HUF`, `IDR`, `INR`, `ISK`, `JPY`, `KRW`, `MAD`, `MXN`, `NZD`, `PLN`, `RUB`, `SAR`, `SGD`, `THB`, `TRY`, `ZAR`
  - `address` SupplierAddress
    - `line1` string
    - `line2` string, nullable
    - `city` string
    - `postalCode` string
    - `country` string, country — ISO 3166-1 alpha-2 country code. Defaults to SE if not provided.
  - `paymentDetails` union
    - object
      - `type` 'bankgiro', required
      - `bankgiroNumber` string, required — The bankgiro number for the supplier
    - object
      - `type` 'plusgiro', required
      - `plusgiroNumber` string, required — The plusgiro number for the supplier
    - object
      - `type` 'transfer', required
      - `clearingNumber` string, required — Bank clearing number
      - `accountNumber` string, required — Bank account number
    - object
      - `type` 'internationalPayment', required
      - `iban` string, required — International Bank Account Number
      - `bic` string, required — Bank Identifier Code (SWIFT code)

## Response `200`

Supplier created

- Supplier
  - `id` string, uuid
  - `name` string, required
  - `orgNumber` string
  - `vatNumber` string
  - `currency` string — ISO 4217 currency code. Defaults to SEK if not provided. Sets the currency for the supplier, which determines the currency used when creating supplier invoices. When a non-SEK currency is set, exchange rates are automatically calculated to determine the correct SEK amount — no manual exchange rate lookup is needed. Allowed values depend on whether the company has a Bokio Business Account (BBA): **With Bokio Business Account:** `SEK`, `EUR`, `NOK`, `USD`, `DKK`, `GBP`, `PLN`, `RON`, `CZK`, `HUF`, `ISK`, `CHF` Note: For companies with a Bokio Business Account, only currencies supported by BBA are available. For supplier invoices that cannot be paid via BBA, the currency must be set to `SEK` and exchange rates must be handled manually. **Without Bokio Business Account:** `SEK`, `GBP`, `EUR`, `USD`, `NOK`, `DKK`, `AUD`, `BRL`, `CAD`, `CHF`, `CNY`, `CZK`, `HKD`, `HUF`, `IDR`, `INR`, `ISK`, `JPY`, `KRW`, `MAD`, `MXN`, `NZD`, `PLN`, `RUB`, `SAR`, `SGD`, `THB`, `TRY`, `ZAR`
  - `address` SupplierAddress
    - `line1` string
    - `line2` string, nullable
    - `city` string
    - `postalCode` string
    - `country` string, country — ISO 3166-1 alpha-2 country code. Defaults to SE if not provided.
  - `paymentDetails` union
    - object
      - `type` 'bankgiro', required
      - `bankgiroNumber` string, required — The bankgiro number for the supplier
    - object
      - `type` 'plusgiro', required
      - `plusgiroNumber` string, required — The plusgiro number for the supplier
    - object
      - `type` 'transfer', required
      - `clearingNumber` string, required — Bank clearing number
      - `accountNumber` string, required — Bank account number
    - object
      - `type` 'internationalPayment', required
      - `iban` string, required — International Bank Account Number
      - `bic` string, required — Bank Identifier Code (SWIFT code)

## Other responses

- `400` — Missing required information

---

[API](https://skmtc.net/bokio/apis/company-api.md) · [All operations](https://skmtc.net/bokio/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bokio/company-api/revisions/1bb5d09ce15e/schema)