curl --request POST \
--url https://api.clickpesa.com/third-parties/billpay/bulk-create-customer-control-numbers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"controlNumbers": [
{
"customerName": "John Doe",
"customerEmail": "john@example.com",
"billAmount": 25000
},
{
"customerName": "Jane Smith",
"customerPhone": "255712345678",
"billReference": "CUST002"
}
]
}
'{
"billPayNumbers": [
"<string>"
],
"created": 123,
"failed": 123,
"errors": [
{
"index": 123,
"reason": "<string>"
}
]
}Bulk create BillPay Customer Control Numbers (max 50 per request). Each item follows the single-create format. Supports partial success — valid items are created; invalid ones are returned in the errors array
curl --request POST \
--url https://api.clickpesa.com/third-parties/billpay/bulk-create-customer-control-numbers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"controlNumbers": [
{
"customerName": "John Doe",
"customerEmail": "john@example.com",
"billAmount": 25000
},
{
"customerName": "Jane Smith",
"customerPhone": "255712345678",
"billReference": "CUST002"
}
]
}
'{
"billPayNumbers": [
"<string>"
],
"created": 123,
"failed": 123,
"errors": [
{
"index": 123,
"reason": "<string>"
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.clickpesa.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorization header containing the JWT access token returned from the generate token endpoint. The token already includes the Bearer prefix. Example: Authorization: Bearer eyJhbGciOi...
Array of customer control number items
1 - 50 elementsShow child attributes
Bulk create result - may include partial success with per-item errors