[Preview] Create a supplier

Creates a new supplier for the company.

Scope: suppliers:write

Request body

idstring uuid

namestring required

orgNumberstring

vatNumberstring

currencystring

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

Example request

{
  "id": "12345678-abcd-1234-abcd-1234567890ab",
  "name": "Example Supplier",
  "orgNumber": "556677-8899",
  "vatNumber": "SE123456789001",
  "currency": "SEK",
  "address": {
    "line1": "Älvsborgsvägen 10",
    "line2": "c/o Test",
    "city": "Gothenburg",
    "postalCode": "123 45",
    "country": "SE"
  },
  "paymentDetails": {
    "type": "bankgiro",
    "bankgiroNumber": "1234-5678"
  }
}

Response

Supplier created