Adwix AtlasPlatform

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#

GEThttps://adwixatlas.com/api/v1/customers
FieldAccepted keysNotes
limit?limit=251–100, default 25.
offset?offset=0Skip N rows. Newest first (created_at desc).
search?search=rahulOptional 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#

POSThttps://adwixatlas.com/api/v1/customers
FieldAccepted keysNotes
namerequiredNon-empty; 422 without it.
phoneoptional
emailoptional
address · stateoptional
tagsoptionalArray 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#

GEThttps://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).