Create WaaS Consumer

Create consumer

This endpoint allows an organization to onboard a new consumer into the Tanda WaaS platform by submitting their personal details (e.g., name, ID number, mobile number, and country). The API returns the created consumer record along with system-generated metadata such as consumer ID, status, timestamps, and associated organization details.

Request Body Parameters

Parameter	Description	Mandatory
firstName	The consumer's first name exactly as it is appears on their identity card e.g `John`	Yes
lastName	The consumer's last name exactly as it is appears on their identity card e.g `Doe`	Yes
countryId	Unique identifier for the country e.g `KE`	Yes
idNumber	The consumer's ID Number exactly as it is appears on their identity card e.g `12345678`	Yes
mobile	The consumer’s mobile number without the country code (e.g., 712345678). This field is required, and the OTP code will be sent to this number.	Yes

Example Request Body

{
  "firstName": "Lawrence",
  "lastName": "Mzing",
  "countryId": "KE",
  "idNumber": "12367890",
  "mobile": "742460938"
}

Sample Response

{
    "id": "14ac3424-c9d7-43cc-b76d-ddc3124410c3",
    "firstName": "Oliver",
    "lastName": "Tambo",
    "status": "New",
    "idNumber": "24743579279",
    "mobile": "+254723009900",
    "datetimeCreated": "2025-09-12T05:41:53.000Z",
    "lastModified": "2025-09-12T05:41:53.000Z",
    "country": {
        "id": "KE",
        "shortName": "Kenya"
    },
    "headOffice": {
        "id": "457cc8a6-4774-4e81-a670-64b9c951a142",
        "name": "Bonface&Sons",
        "tradingName": "Bonface&Sons"
    }
}