Create Customer

post https://api.next-tech.com/v1/customer/

Body Params

active

boolean

Defaults to true

If this customer is active and in use

apartmentno

string | null

Number of the apartment

bankaccountno

string | null

Account no in bank

bankname

string | null

Name of bank

billaddress1

string | null

Address line 1, usually name

billaddress2

string | null

Address line 2, usually street address

billaddress3

string | null

Address line 3, usually secondary street address information, building number, box, etc.

billaddress4

string | null

Address line 4, usually postal number

billaddress5

string | null

Address line 5, usually city

billaddress6

string | null

Address line 6, usually country

billingtermsid

integer | null

Billing terms (id). Will be used on the invoice

clearingno

string | null

Clearing no

constructioncompany

boolean

Defaults to false

If the company is a construction company. Controls if the company by default is invoiced VAT. Is not allowed to be 'true' when novat is 'true'

countrycode

string | null

Country code

creditrisk

boolean

Defaults to false

Indicates that the customer is considered a credit risk. A null value RETURNED from the server means the current client does not have the rights to read this value.

currencyid

integer

Currency (id) for the customer. If a value is left out when a record is created, the default currency will be used.

customerno

string | null

Number of customer/supplier, used in connection to external system

customernote

string | null

Internal notes about the customer/supplier

customertypeid

integer

required

Type (id) of customer/supplier (Company, Private, Government...)

defaultexternalworkorderstatusid

integer | null

External workorder status that should be inherited to workorders of this customer/supplier

eancode

string | null

EAN Code

ediAddress

string | null

EDI Address

string | null

Email to customer/supplier

externalid

string | null

Id in external system. Null if created in NEXT and not yet exported

fax

string | null

Fax

frameworkcontractid

integer | null

Framework Contract to be set on workorders for this customer

housingcooperativeorgno

string | null

Organization no (Housing cooperative)

iban

string | null

IBAN

invoiceemail

string | null

Email to use when sending invoices to customer

invoicetypeid

integer | null

The Id of the associated invoice type

isalsosupplier

boolean

Defaults to false

This customer is also a supplier. It exists with the same id in the supplier endpoint and changes here are reflected there as well

markup

number | null

Markup percentage

mobile

string | null

Mobile phone, can be used for SMS

name

string

required

length ≤ 50

Name of customer/supplier

novat

boolean

Defaults to false

If NO VAT should be applied to invoices by default. Is not allowed to be 'true' when constructioncompany is 'true'

organizationno

string | null

Organization identification number or personal number

phone

string | null

Primary phone

privateperson

boolean

Defaults to false

If customer is a private person

propertyname

string | null

Name of property

swiftbic

string | null

SWIFT / BIC

useinvoicefee

boolean

Defaults to false

Indicates if invoice fee should be added on invoices to this customer

vatno

string | null

VAT number

webaddress

string | null

Web address

Responses

Response body

object

integer

required

Id of record, used as primary key when looking up items using the API

changed

date-time

required

Timestamp of the last time the object was modified

changeduserid

integer

required

The Id of the user that last made changes to the object

created

date-time

required

Timestamp of when the object was first created

createduserid

integer

required

The Id of the user that first created the object

active

boolean

Defaults to true

If this customer is active and in use

apartmentno

string | null

Number of the apartment

bankaccountno

string | null

Account no in bank

bankname

string | null

Name of bank

billaddress1

string | null

Address line 1, usually name

billaddress2

string | null

Address line 2, usually street address

billaddress3

string | null

Address line 3, usually secondary street address information, building number, box, etc.

billaddress4

string | null

Address line 4, usually postal number

billaddress5

string | null

Address line 5, usually city

billaddress6

string | null

Address line 6, usually country

billingterms

string | null

Billing terms (description). Will be used on the invoice

billingtermsid

integer | null

Billing terms (id). Will be used on the invoice

clearingno

string | null

Clearing no

constructioncompany

boolean

Defaults to false

If the company is a construction company. Controls if the company by default is invoiced VAT. Is not allowed to be 'true' when novat is 'true'

countrycode

string | null

Country code

creditrisk

boolean

Defaults to false

Indicates that the customer is considered a credit risk. A null value RETURNED from the server means the current client does not have the rights to read this value.

currencycode

string

required

length ≤ 3

Currency (code) for the customer/supplier

currencyid

integer

Currency (id) for the customer. If a value is left out when a record is created, the default currency will be used.

customerno

string | null

Number of customer/supplier, used in connection to external system

customernote

string | null

Internal notes about the customer/supplier

customertypeid

integer

required

Type (id) of customer/supplier (Company, Private, Government...)

customertypename

string

required

length ≤ 50

Type (name) of customer/supplier (Company, Private, Government...)

defaultexternalworkorderstatusid

integer | null

External workorder status that should be inherited to workorders of this customer/supplier

eancode

string | null

EAN Code

ediAddress

string | null

EDI Address

string | null

Email to customer/supplier

externalid

string | null

Id in external system. Null if created in NEXT and not yet exported

fax

string | null

Fax

frameworkcontractid

integer | null

Framework Contract to be set on workorders for this customer

hasfavorites

boolean

Has favorites

hasprices

boolean

Has prices

housingcooperativeorgno

string | null

Organization no (Housing cooperative)

iban

string | null

IBAN

invoiceemail

string | null

Email to use when sending invoices to customer

invoicetypeid

integer | null

The Id of the associated invoice type

invoicetypename

string | null

Type of invoice (Email, paper...)

isalsosupplier

boolean

Defaults to false

This customer is also a supplier. It exists with the same id in the supplier endpoint and changes here are reflected there as well

markup

number | null

Markup percentage

mobile

string | null

Mobile phone, can be used for SMS

name

string

required

length ≤ 50

Name of customer/supplier

novat

boolean

Defaults to false

If NO VAT should be applied to invoices by default. Is not allowed to be 'true' when constructioncompany is 'true'

organizationno

string | null

Organization identification number or personal number

phone

string | null

Primary phone

privateperson

boolean

Defaults to false

If customer is a private person

propertyname

string | null

Name of property

swiftbic

string | null

SWIFT / BIC

useinvoicefee

boolean

Defaults to false

Indicates if invoice fee should be added on invoices to this customer

vatno

string | null

VAT number

webaddress

string | null

Web address

Language

Credentials

OAuth2

URL


xxxxxxxxxx
15
1
curl --request POST \
2
     --url https://api.next-tech.com/v1/customer/ \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "active": true,
8
  "constructioncompany": false,
9
  "creditrisk": false,
10
  "isalsosupplier": false,
11
  "novat": false,
12
  "privateperson": false,
13
  "useinvoicefee": false
14
}
15
'


xxxxxxxxxx
56
}
1
{
2
  "id": 5,
3
  "changed": "2025-04-12T14:25:00.398Z",
4
  "changeduserid": 7,
5
  "created": "2025-04-12T14:25:00.398Z",
6
  "createduserid": 3,
7
  "active": false,
8
  "apartmentno": "15",
9
  "bankaccountno": "6547 893216 5478",
10
  "bankname": "Handelsbanken",
11
  "billaddress1": "Builders 'R Us",
12
  "billaddress2": "Generic Street 15",
13
  "billaddress3": "Box 456",
14
  "billaddress4": "543 21",
15
  "billaddress5": "Gothenburg",
16
  "billaddress6": "Sweden",
17
  "billingterms": "30 days",
18
  "billingtermsid": 2,
19
  "clearingno": "8480",
20
  "constructioncompany": true,
21
  "countrycode": "SE",
22
  "creditrisk": false,
23
  "currencycode": "SEK",
24
  "currencyid": 4,
25
  "customerno": "000250",

200Successful Response

422Validation Error