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
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
Authorization
string
Your test or live API key
Request Body
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
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?