Klant aanmaken
Creates a customer.
All fields are required except address.street2, bankAccounts and payrollProviders. Bank accounts and payroll providers can be included now or added later.
Mandate signature requests are sent to the contact.
Any field outside the documented ones is rejected with unknownField.
An enterprise number can belong to only one accounting firm. If another firm already registered it, the call returns 403 belongsToAnotherTenant.
In that case, the accountant must contact Codaclean support to start a transfer procedure, which requires the end customer’s agreement.
Required scope: customers:write
Autorisaties
Identifies the partner software. Issued by Codaclean. Required on every call, including POST /token.
Identifies the user and their accounting firm. Send the idToken returned by POST /token as Authorization: Bearer <idToken>. Valid for 1 hour.
Body
Belgian enterprise number, formatted 0123.456.789: 10 digits with dots, without the BE prefix. Its check digits are validated, and it must be unique across Codaclean.
^[01]\d{3}\.\d{3}\.\d{3}$Non-empty.
Your internal reference for the customer.
All fields are required except street2.
All fields are required. Mandate signature requests are sent to this contact.
Only iban is accepted. BIC and bank name are derived by Codaclean.
Only code is accepted. See POST /payroll-providers.
Respons
Customer created.
Fields without a value are omitted from the response. Arrays are always present.
Belgian enterprise number, formatted 0123.456.789.
Contact person at the customer. Mandate signature requests are sent to this contact.
Confidential customers are only visible to users with the Administrator access level.
Active bank accounts only.
Active payroll providers only.

