Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wilow.app/llms.txt

Use this file to discover all available pages before exploring further.

Register a new customer or retrieve an existing one (matched by mobile number). Returns a customer token for subsequent requests. 
POST /external-partner/customers/link-customer
Headers
HeaderValue
API-KEYYour partner API key
Idempotency-KeyUnique UUID
Accept-Languagear or en
Body multipart/form-data
FieldTypeRequiredNotes
namestring✅Customer’s full name
mobilestring✅Saudi mobile number without country code
date_of_birthstring✅Format: YYYY-MM-DD
genderstring✅male or female
family_statusstring❌married, single, etc.
latfloat❌Customer’s latitude
longfloat❌Customer’s longitude
Response 
{
  "success": true,
  "data": {
    "auth_token": "4055|5TJnGse60PlKk8PSmxHXz3HjgbaDAMvv5Z5mrGSF...",
    "customer_id": 961,
    "is_location_covered": true,
    "coverage_message": "Your location is covered by our service",
    "customer": {
      "id": 961,
      "name": "Ahmed Ali",
      "mobile": "501214561",
      "gender": { "code": "male", "name": "Male" },
      "language": { "code": "en", "name": "English" }
    }
  },
  "status_code": 200
}
Store the auth_token — it’s required as Authorization: Bearer {token} for all customer-scoped endpoints.
Error — Invalid mobile (422) 
{
  "success": false,
  "message": "The given data was invalid.",
  "errors": {
    "mobile": ["The mobile format is invalid."]
  }
}