Create customer

Customer creation is elemental to the Notify API: this is where most invoice implementations start off. Once you have created a customer, you can create invoices for the customer. without a customer id, you can't create invoices. So always start with the customer API first or search for the customer id. In both responses you'll find the unique customer id you can use for your invoices.

Create customer

POST https://api.notify.cm/v2/customers

Authentication: API keys

Query Parameters

Name
Type
Description

Overwrite

boolean

Optional if you want to overwrite information when a customer with the same CustomerCode already exists. we advise to use the update API instead.

Headers

Name
Type
Description

Authorization

string

Your test or live API key

Request Body

Name
Type
Description

CustomerCode

string

Your unique customer code. Max. 250 characters

Name

string

The name of the customer. Max 250 characters

Address

string

Max. 250 characters

Postalcode

string

Max. 10 characters

City

string

Max. 250 characters

Country

string

Two characters country code, see documentation

Contact

string

The full name of the contact. Max 250 characters

Phone

string

Max. 20 characters

Mobile

string

Max. 20 characters

Email

string

Max. 250 characters

InvoiceEmail

string

Address for invoices only. Max. 250 characters

RegistrationNumber

string

Chamber of Commerce Registration number

Language

string

Language code. See documentation

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

{
        "resource": "customer",
        "id": "a0f0660d-6c8d-422b-8114-e363b260521e",
        "customerCode":"10001",
        "name":"Creditpartners B.V.",
        "address": {
                "address":"",
                "postalcode":"",
                "city":"",
                "country":"NL"
        },
        "contact":"",
        "phone":"",
        "mobile":"",
        "email":"[email protected]",
        "invoiceEmail":"",
        "registrationNumber":"",
        "language":"dutch"
}

Example

curl -X POST https://api.notify.cm/v2/customers \
   -H "Authorization: Bearer test_R7HQ9QpXgx8J32rW9X9UyXjgfNk6C7TQ2UD8M5rwf8vVnYxnSETvSuEC6SKFW8Ug" \
   -d "number=10001" \
   -d "name=Creditpartners B.V." \
   -d "[email protected]"

Response

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

{
        "resource": "customer",
        "id": "a0f0660d-6c8d-422b-8114-e363b260521e",
        "customerCode":"10001",
        "name":"Creditpartners B.V.",
        "address": {
                "address":"",
                "postalcode":"",
                "city":"",
                "country":"NL"
        },
        "contact":"",
        "phone":"",
        "mobile":"",
        "email":"[email protected]",
        "invoiceEmail":"",
        "registrationNumber":"",
        "language":"dutch"
}

Last updated

Was this helpful?