Create User

POST

http://localhost:8080/api/v3/users

POST

/api/v3/users

curl -X POST http://localhost:8080/api/v3/users \
     -H "Authorization: Bearer {{accessToken}}" \
     -H "X-Device-Id: {{deviceId}}" \
     -H "X-Request-Id: {{requestId}}" \
     -H "X-Signature: {{signature}}" \
     -H "X-Timestamp: {{timestamp}}" \
     -H "Content-Type: application/json" \
     -d '{
  "firstName": "Jane",
  "lastName": "Doe",
  "phone": "0712345678",
  "nationalId": "12345678",
  "gender": "FEMALE",
  "dob": "1990-01-01",
  "kraPinIndividual": "A123456789Z",
  "acceptedTerms": true,
  "acceptedPrivacyPolicy": true,
  "email": "jane.doe@sare.africa",
  "roleIds": [
    "e4c0c3d4-6b7a-4c8d-9e0f-1a2b3c4d5e6f"
  ]
}'

{
  "code": 201,
  "message": "User created successfully",
  "data": {
    "id": "f5c1d4e5-2a3b-4c5d-8e9f-0a1b2c3d4e5f",
    "fullName": "Jane Doe",
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "jane.doe@sare.africa",
    "phone": "254712345678",
    "identificationNumber": "12345678",
    "roles": [
      "SALES_AGENT"
    ],
    "isShofcoMember": false
  }
}

Headers

Request

This endpoint expects an object.

firstNamestringOptional

lastNamestringOptional

phonestringOptionalformat: "utc-millisec"

nationalIdstringOptionalformat: "utc-millisec"

genderstringOptional

dobdateOptional

kraPinIndividualstringOptional

acceptedTermsbooleanOptional

acceptedPrivacyPolicybooleanOptional

emailstringOptionalformat: "email"

roleIdslist of stringsOptional

Response

201 Created

codeintegerOptional

messagestringOptional

dataobjectOptional

Errors

400

Bad Request Error