Skip to content
KasblyKasbly Docs

Create a new customer

POST
/api/v1/customers
curl --request POST \
  --url https://api.dokanmazad.com/api/v1/customers \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "name": "Ahmed Ali", "mobileNumber": "+971501234567", "email": "ahmed@example.com", "country": "UAE" }'

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
name
required

Customer full name

string
mobileNumber
required

Customer phone (E.164 preferred)

string
email

Customer email

string
idNumber

Passport or national ID number

string
country

Country code or name

string
address

Customer address

string
Examples
Exampledefault
{
  "name": "Ahmed Ali",
  "mobileNumber": "+971501234567",
  "email": "ahmed@example.com",
  "country": "UAE"
}

Responses

Section titled “Responses”

201

Section titled “201”

Success

Media typeapplication/json
object
success
required
boolean
data
required
meta
object
page
integer
limit
integer
total
integer
totalPages
integer
data
required
object
id
required

New customer CUID (use as customerId in POST /orders)

string
name
required

Customer name

string
mobileNumber
required

Customer phone

string
walletBalance
required

Initial wallet balance (0)

number
createdAt
required

Creation timestamp

string format: date-time
Examples
Examplesuccess
{
  "success": true,
  "data": {
    "id": "cmoabcde000001ny11aabbcc0",
    "name": "Ahmed Ali",
    "mobileNumber": "+971501234567",
    "email": "ahmed@example.com",
    "walletBalance": 0,
    "createdAt": "2026-05-12T10:00:00.000Z"
  }
}

401

Section titled “401”

Unauthorized — missing or invalid API key

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

403

Section titled “403”

Forbidden — route not in this key’s allowedRoutes

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

429

Section titled “429”

Rate limit exceeded

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying