Create Kollo | Kollo | Documentation

curl -X POST https://https//https/kollo \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "type": "flexible",
  "name": "Sunny days",
  "description": "Buy myself another new car",
  "contribution_amount": 8900,
  "frequency": "monthly"
}'

{
  "message": "New Car Kollo created successfully",
  "body": {
    "kollo": {
      "name": "New Car",
      "description": "Buy myself a new car",
      "type": "fixed",
      "contributionAmount": 127500,
      "targetDate": "2025-07-09",
      "createdBy": "cad93347-d28d-49bc-8960-1c326ad9832e",
      "kolloId": "167681bd-028a-4759-9aa9-bae1902f6538",
      "status": "active",
      "createdAt": "2025-06-19T23:17:01Z",
      "updatedAt": "2025-06-19T23:17:01Z",
      "account": {
        "accountId": "bcea1b7d-a95a-4df1-bb1e-e06dad6feeb7",
        "accountType": "kollo",
        "balance": "127500",
        "currency": "NGN",
        "status": "verified",
        "details": {},
        "customerId": "cad93347-d28d-49bc-8960-1c326ad9832e",
        "kolloId": "167681bd-028a-4759-9aa9-bae1902f6538",
        "createdAt": "2025-06-19T23:17:01Z",
        "updatedAt": "2025-06-19T23:17:01Z"
      },
      "progressPercentage": 100
    }
  }
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

typestringRequired

namestringRequired

descriptionstringRequired

contribution_amountintegerRequired

frequencystringRequired

Response

messagestring

bodyobject