Customers API
List, create and fetch your customer book. Useful for migrating an existing customer base into Atlas or keeping another system's contact list in sync.
List customers#
GET
https://adwixatlas.com/api/v1/customers| Field | Accepted keys | Notes |
|---|---|---|
| limit | ?limit=25 | 1–100, default 25. |
| offset | ?offset=0 | Skip N rows. Newest first (created_at desc). |
| search | ?search=rahul | Optional case-insensitive match on name, phone or email. |
Request
curl "https://adwixatlas.com/api/v1/customers?search=rahul" \ -H "Authorization: Bearer aa_live_xxxxxxxxxxxxxxxx"
Create a customer#
POST
https://adwixatlas.com/api/v1/customers| Field | Accepted keys | Notes |
|---|---|---|
| name | required | Non-empty; 422 without it. |
| phone | optional | |
| optional | ||
| address · state | optional | |
| tags | optional | Array of strings (max 20). |
Request
curl -X POST https://adwixatlas.com/api/v1/customers \
-H "Authorization: Bearer aa_live_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"name": "Rahul Sharma",
"phone": "+91 98765 43210",
"email": "rahul@example.com",
"address": "Andheri West, Mumbai",
"state": "Maharashtra",
"tags": ["honeymoon", "repeat"]
}'Response — 201
{
"data": {
"id": "9b1e6a2c-…",
"name": "Rahul Sharma",
"phone": "+91 98765 43210",
"email": "rahul@example.com",
"address": "Andheri West, Mumbai",
"state": "Maharashtra",
"tags": ["honeymoon", "repeat"],
"total_bookings": 0,
"total_spend": 0,
"last_travel_date": null,
"created_at": "2026-07-21T09:20:11.000Z",
"updated_at": "2026-07-21T09:20:11.000Z"
}
}total_bookings, total_spend and last_travel_date are read-only — Atlas computes them from actual bookings; values sent for them are ignored.
Fetch one customer#
GET
https://adwixatlas.com/api/v1/customers/{id}Returns { "data": { … } } or 404 — ids from another workspace are indistinguishable from non-existent ones.
The API doesn't de-duplicate customers — importing the same person twice creates two records. For migrations, de-dupe on phone/email on your side first (that's also the order Atlas agents search by).
