Update customer phone number (tenant-scoped)
PATCH
/api/v1/customers/{id}/phone
const url = 'https://api.dokanmazad.com/api/v1/customers/cmoabcde000001ny11aabbcc0/phone';const options = { method: 'PATCH', headers: {'X-API-Key': '<X-API-Key>', 'Content-Type': 'application/json'}, body: '{"mobileNumber":"+971509999888"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://api.dokanmazad.com/api/v1/customers/cmoabcde000001ny11aabbcc0/phone \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <X-API-Key>' \ --data '{ "mobileNumber": "+971509999888" }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string
Customer CUID
Example
cmoabcde000001ny11aabbcc0Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
mobileNumber
required
New customer phone (E.164 preferred, e.g. +971501234567). Trimmed server-side.
string
Examples
Exampledefault
{ "mobileNumber": "+971509999888"}Responses
Section titled “Responses”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
Customer CUID
string
mobileNumber
required
Updated phone
string
updatedAt
required
Update timestamp
string format: date-time
Examples
Examplesuccess
{ "success": true, "data": { "id": "cmoabcde000001ny11aabbcc0", "mobileNumber": "+971509999888", "updatedAt": "2026-05-12T11:00:00.000Z" }}Unauthorized — missing or invalid API key
Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{ "success": false}Forbidden — route not in this key’s allowedRoutes
Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{ "success": false}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