Legg til en kunde

POST/api/v1/customers

Virker

Org.nr. sjekkes; samme org.nr. to ganger gir 409 med den første kundens id. Ikke med en testnøkkel.

Rettigheter: customers:write
Kundenøkkel: Nei
Grense: skriving, 30 i minuttet
Siden: 5. oktober 2026

Parametre

Overskrifter

Idempotency-KeystringMå med8–255 tegn
8–255 tegn. Bruk en UUID per forsøk på en handling; samme nøkkel og samme innhold gir samme svar igjen.

Det du sender

application/jsonCreateCustomerRequestMå med

namestringMå med1–200 tegn
kindstring
Verdierfirmaprivat
orgNrstringkan være nullhøyst 20 tegn
contactPersonstringkan være nullhøyst 300 tegn
emailstringkan være nullhøyst 300 tegn
mobilestringkan være nullhøyst 30 tegn
phonestringkan være nullhøyst 30 tegn
invoiceAddressobjectkan være null
Vis 4 feltSkjul 4 felt
- linestringkan være nullhøyst 300 tegn
- postalCodestringkan være nullhøyst 10 tegn
- citystringkan være nullhøyst 100 tegn
- countrystringkan være nullhøyst 100 tegn
deliveryAddressobjectkan være null
Vis 4 feltSkjul 4 felt
- linestringkan være nullhøyst 300 tegn
- postalCodestringkan være nullhøyst 10 tegn
- citystringkan være nullhøyst 100 tegn
- countrystringkan være nullhøyst 100 tegn
smsOnReadyboolean
invoicingModestring
Verdierper_ordreper_prosjektprosjekt_mnd
requiresProjectNoboolean
requiresOrdererboolean
deliveryWeekdaysinteger[]kan være null

Svaret

201CreatedKunden er lagt til

application/jsonCustomer

Vis alle 20 feltSkjul de 20 feltene

idstring · uuidMå med
UUID
numberintegerMå medkan være null
Kundenummeret i registeret (1, 2, 3 …).
kindstringMå med
Verdierfirmaprivat
namestringMå med
orgNrstringMå medkan være null
contactPersonstringMå medkan være null
emailstringMå medkan være null
mobilestringMå medkan være null
Nummeret Klar-SMS går til, +47…
phonestringMå medkan være null
invoiceAddressobjectMå medkan være null
Vis 4 feltSkjul 4 felt
- linestringMå medkan være null
- postalCodestringMå medkan være null
- citystringMå medkan være null
- countrystringMå medkan være null
deliveryAddressobjectMå medkan være null
Vis 4 feltSkjul 4 felt
- linestringMå medkan være null
- postalCodestringMå medkan være null
- citystringMå medkan være null
- countrystringMå medkan være null
invoicingModestringMå med
Verdierper_ordreper_prosjektprosjekt_mnd
requiresProjectNobooleanMå med
«Krever prosjektnr»: en ordre uten prosjektnummer blir avvist.
requiresOrdererbooleanMå med
«Krever bestiller».
smsOnReadybooleanMå med
deliveryWeekdaysinteger[]Må medkan være null
Faste leveringsdager, 1 = mandag … 7 = søndag.
erpRefsobject[]Må med
Kunden i regnskapet. Da eier regnskapet navn og org.nr.
Vis 2 feltSkjul 2 felt
- vendorstringMå med
  Verdierpowerofficetripletexfiken
- externalNostringMå med
archivedbooleanMå med
createdAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
Tidspunkt, ISO 8601 i UTC
updatedAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
Tidspunkt, ISO 8601 i UTC

Feilkoder

Alle feil har samme form. Velg handling etter code, aldri etter message. Les mer under Feil.

400Bad Request

invalid_jsonInnholdet er ikke gyldig JSON.
invalid_requestNoe i forespørselen er feil eller ukjent. fields sier hva.

401Unauthorized

unauthorizedNøkkelen mangler, er feil, er slått av eller har gått ut. En nøkkel som slås av, slutter å virke innen 1 minutt.

403Forbidden

account_closedVerkstedet er stengt.
customer_key_not_allowedEn kundenøkkel kan ikke gjøre dette.
dpa_requiredVerkstedet må godta databehandleravtalen før koblinger kan brukes.
feature_not_in_planVerkstedet har ikke slått på delen dette trenger. feature sier hvilken.
insufficient_scopeNøkkelen har ikke lov til dette. requiredScope sier hvilken rett som mangler.
test_key_not_allowedEn testnøkkel kan ikke dette: den endrer aldri kunderegisteret, og et avrop er alltid en ekte ordre.

409Conflict

customer_existsEn kunde med dette org.nr. finnes allerede. id er kunden.
idempotency_in_progressEn forespørsel med samme Idempotency-Key holder på. Prøv igjen om litt.
key_owner_missingBrukeren som laget nøkkelen finnes ikke lenger. Lag en ny nøkkel.

422Unprocessable Entity

customer_invalidNoe i kundefeltene er feil. fields sier hva.
idempotency_key_reusedDenne Idempotency-Key ble brukt på en annen forespørsel. Bruk en ny nøkkel for ny handling.

428Precondition Required

idempotency_key_requiredSend Idempotency-Key med denne forespørselen.

429Too Many Requests

rate_limitedFor mange kall. Vent retryAfterSeconds sekunder.

500Internal Server Error

internalNoe gikk galt hos oss. Feilen er meldt. Oppgi requestId hvis du spør.

POST/customers

curl https://vbeslag.com/api/v1/customers \
  -H "Authorization: Bearer vb_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c2e9a-0d5b-4a7e-9f31-2b8c4d7e1a90" \
  -d '{
    "name": "Byggmester Hansen AS"
  }'

const res = await fetch('https://vbeslag.com/api/v1/customers', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer vb_test_…',
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    name: 'Byggmester Hansen AS',
  }),
})
const data = await res.json()

$ch = curl_init('https://vbeslag.com/api/v1/customers');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer vb_test_…',
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'name' => 'Byggmester Hansen AS',
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Svaret

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "87febf70-b0ae-4c70-a5cd-01339c01bce3",
  "number": 312,
  "kind": "firma",
  "name": "Byggmester Hansen AS",
  "orgNr": "914276640",
  "contactPerson": "Kari Nordmann",
  "email": "kari@example.no",
  "mobile": "+4791234567",
  "phone": "+4791234567",
  "invoiceAddress": {
    "line": "Industriveien 4",
    "postalCode": "9405",
    "city": "Harstad",
    "country": "NO"
  },
  "deliveryAddress": {
    "line": "Industriveien 4",
    "postalCode": "9405",
    "city": "Harstad",
    "country": "NO"
  },
  "invoicingMode": "per_ordre",
  "requiresProjectNo": false,
  "requiresOrderer": false,
  "smsOnReady": false,
  "deliveryWeekdays": [
    1
  ],
  "erpRefs": [
    {
      "vendor": "poweroffice",
      "externalNo": "tekst"
    }
  ],
  "archived": false,
  "createdAt": "2026-12-14T09:03:00.000Z",
  "updatedAt": "2026-12-14T09:03:00.000Z"
}