Skip to content

Create Customer

Get Started > API User Guide > Create Customer

To create a sample individual customer, only 4 attributes are required, as illustrated by the sample call below. However, the richer information you provide about your customer, the more accurate our matching engine will be. Copy and execute the sample cURL code below to get started.

Example request:

Terminal window
curl -X POST https://sandbox.cleardil.com/v1/customers \
-H 'Authorization: Bearer your_token' \
-H 'Content-Type: application/json' \
-d '{
"type" : "INDIVIDUAL",
"email" : "jon@doe.com",
"first_name" : "Jon",
"last_name" : "Doe"
}'

Example response:

{
"id": "9852967d-3f52-496b-955d-e737abd8c246",
"type" : "INDIVIDUAL",
"email": "jon@doe.com",
"first_name": "Jon",
"last_name": "Doe",
"created_at": "2018-02-09T00:00:30Z",
"updated_at": "2018-02-09T00:00:30Z",
"_links": {
"self": {
"href": "https://sandbox.cleardil.com/v1/customers/9852967d-3f52-496b-955d-e737abd8c246"
},
"documents": {
"href": "https://sandbox.cleardil.com/v1/customers/9852967d-3f52-496b-955d-e737abd8c246/documents"
},
"customer": {
"href": "https://sandbox.cleardil.com/v1/9852967d-3f52-496b-955d-e737abd8c246"
}
}
}

Please refer to customer API reference for further information regarding customer creation.