Skip to main content

​
Endpoint

POST /api/sandbox/v1/multiaccount/new/organisation

​
Base URL

https://api.kiotapay.co

​
Request Headers

KeyValueRequiredDescription
Content-Typeapplication/json✅Specifies that the request body is in JSON format.
AuthorizationBearer <your-token>✅API authentication token. Replace <your-token> with a valid JWT.

​
Request Body

{
    "name":"subaccount",
    "email":"[email protected]",
    "phone":"25475698082",
    "user":{
    "userType":"API_USER",
    "firstName":"jon",
    "lastName":"doe",
    "username":"johndoe",
    "password":"password12",
    "roles": ["ADMIN"],
    "email":"[email protected]"
    }
}
Explanation
FieldTypeDescription
nameStringThe sub account name
emailstringThe sub account email address.
phoneStringA sub account phone number .
userjsonExpected user details which will be tied to the new organisation user
Sample Response Body 
{
    "status": 201,
    "message": "Created Successfully",
    "data": {
        "uuid": "e09a5d6c-7f98-4b47-845d-e8420c012b32",
        "name": "subaccount",
        "phoneNumber": "25475698082",
        "email": "[email protected]",
        "uniqueReference": "4780606363",
        "environment": null,
        "createdAt": "2025-05-01T08:24:36.00312271",
        "updatedAt": "2025-05-01T08:24:36.00312271",
        "collectionCallbackUrl": null,
        "parentOrganisation": {
            "uuid": "4d6e1ea9-5ab8-496a-978f-7e9b2bce80c4",
            "name": "Maina Properties Limited Ke",
            "phoneNumber": "254745362174",
            "email": "[email protected]",
            "uniqueReference": "4780606",
            "environment": null,
            "createdAt": "2025-01-24T13:35:12.151225",
            "updatedAt": "2025-01-24T13:35:12.151225",
            "collectionCallbackUrl": "https://www.youtube.com/watch?v=1J7wGZEWnMI",
            "parentOrganisation": null,
            "parent": true
        },
        "parent": false
    }
}