Create Customer

Creates a new record.

POSThttps://api.tracksales.co/api/v1/customers

Required scope: customers:create

Body Params

namestringrequired

Customer name

emailstring

Email address

phonestring

Phone number

Responses

201Created

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Customers was not found.

422Validation Error

Request validation failed.

curl -X POST 'https://api.tracksales.co/api/v1/customers' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Acme Ltd","email":"[email protected]"}'

{
    "success": true,
    "data": {
        "customer_id": 42,
        "name": "Acme Ltd",
        "email": "[email protected]",
        "phone": "+254700000000"
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Customers not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}