PUT (update) one customer

Update details on an existing customer.

If a field (key-value pair) is missing from the input data set or the input value is null, existing data on the customer will be kept unchanged;

Except: If you change at least one of the fields in the postal address field group (PAFG), all fields in the postal address field group will be changed. Blank ("") is a valid value to change to. I.e. if you pass in a value for postalAddress1, but not for any of the other fields in the postal address field group, the other fields in the group will be set to blank. If you for example want to change the spelling of the street address or add a country code to an existing address, you must supply relevant values for all PAFG fields. If you don't want to change postal address, all PAFG fields must be null, same as before or not present in input. PAFG fields are: all fields under postalAddress except name

There are two ways to update/PUT customers:

Use PUT /clients/{clientno}/customers to update one customer; input one customer object. The data will be validated and customer updated immediately. You will get a response describing the status and result. The updated customer data will be avalibale immediately. Or:

Use PUT /clients/{clientno}/customers/batches to update a batch of customers; input an array of customer objects. The data will be stored, but not processed immediately. The output will present a batchUuid that you must keep track of. Processing is done asynchronously (later) and the bathcUuid can be used to retrieve the batch processing status and result using GET /clients/{clientno}/batches/{batchuuid}

curl --location --request PUT '/clients//customers' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "metadata": { "userId": "TestUser" }, "customer": { "customerNo": "543210", "name": "Owe Armstrong", "postalAddress": { "addressLine1": "C/O ARMchair industries", "addressLine2": "707 Arm street", "addressLine3": "Appartment 8", "postalCode": "1234", "cityName": "Oslo", "countryText": "Norway", "countryCode": "NO" }, "customerCategory": "CONS", "emailAddressDocument": [ "owea@testarmrest.no" ], "secondaryEmailAddress": [ "test2.email@testarmrest.no" ], "phoneNo": "99887766", "secondaryPhoneNo": "997755332", "organizationNo": "984842252", "ssn": "12015641779", "ssnCountry": "NO", "dateOfBirth": "1956-01-12", "yearOfBirth": 1956, "informalName": "Oa", "customerGroupCode": "VIP", "priceNetOrGross": "B", "language": "no", "currency": "NOK", "distribution": { "type": "M", "einvoiceCode": 0 }, "sellerReference": "ARMref", "buyerReference": "OA", "bankAccountNo": "815013665841", "stopReminderUntil": "2026-01-01", "stopReminderMemo": "Agreed with customer", "stopDebtCollectionUntil": "2026-01-01", "stopDebtCollectionMemo": "Agreed with customer", "stopInterestCalcUntil": "2026-01-01", "stopInterestCalcMemo": "Agreed with customer", "efakturaBlockIds": [ "12345678", "23456789", "34567890" ], "peppolBlockIds": [ "987654321", "876543210", "976543210" ], "digipostBlockIds": [ "owe.armstrong#6UY", "bill.lossius#8HM" ], "dueDays": 17, "vatLiable": true, "limitAmount": 2000, "discountRate": 5.5, "activeStatusWeb": "Passive", "customerMessage": "Happy holidays!", "options": [ "NoUpdatePostalReturn" ] } }'

{ "status": "PROCESSED", "result": "UPDATED", "message": "Customer updated", "clientNo": 2218, "accountNo": 500002, "customerNo": "543210", "warnings": [ { "field": "EmailAddressDocument", "message": "Email address owea@ testarmrest.no was sanitized: owea@testarmrest.no was s" } ] }

PUT (update) one customer

Request

Responses