Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.
- 🗂️ Overview
- 🚀 Start Here
- Create your First App
- Responses
- Rate Limiting
- Authorization
- StoreFront Events
- Zid MUI
- Zid SDKs
- Our custom MCP server
- Merchant APIs
- Account
- Orders
- Reverse Orders
- Abandoned Carts
- Products
- Inventories
- Shipping
- Marketing
- Customers
- Store Settings
- Countries and Cities
- Webhooks
- App Management
Add Customer
POST
https://api.zid.sa/v1/managers/store/customers
🔑Scopes
third_customers_write - Modify the customer listRequest
Header Params
Body Params multipart/form-data
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.zid.sa/v1/managers/store/customers' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en' \
--form 'type="individual"' \
--form 'name="example customer"' \
--form 'mobile="966500000003"' \
--form 'email="customer@google.com"' \
--form 'gender="male"' \
--form 'business_name=""' \
--form 'tax_number=""' \
--form 'commercial_registration=""'Responses
🟢200OK
application/json
Bodyapplication/json
Example
{
"status": "object",
"customer": {
"id": 2387703,
"name": "example customer",
"email": "customer@google.com",
"mobile": "966500000003",
"gender": "male",
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": {
"id": "3156d4f1-40d2-4190-867b-65b5fe18a251",
"external_id": "202512111241043429",
"store_id": "c456f2ce-66d3-41f7-8d59-d1c9c4b7d81c",
"customer_id": 2387703,
"loyalty_provider": "local",
"points": 0,
"pending_points": 0,
"total_positive_points": 0,
"total_negative_points": 0,
"created_at": "2025-12-11T12:41:04.000000Z",
"updated_at": "2026-01-09T18:53:14.000000Z",
"deleted_at": null,
"pending_negative_points": 0,
"status": 7
},
"order_total_payments": "0.00000000000000",
"last_order_date": null,
"created_at": "2026-05-18T09:37:26.000000Z",
"updated_at": "2026-05-18T09:37:26.000000Z",
"city": null,
"nickname": "example customer",
"pivotEmail": "customer@google.com",
"pivotMobile": "966500000003",
"order_counts": 0,
"tags": []
},
"message": {
"type": "object",
"code": null,
"name": null,
"description": null
}
}🟠401Unauthorized
🔴500Internal Server error
🟠422Unprocessable Entity
Modified at 2026-05-18 09:44:11