For years, Kenyan taxpayers have dreaded the annual June 30th tax filing deadline. The iTax portal, while functional, has often been criticized for being slow, complex, and difficult to navigate on mobile phones. But those days are coming to an end.
The Kenya Revenue Authority (KRA) has launched a revolutionary way to file tax returns: via WhatsApp. Introducing "Shuru" — KRA’s official AI-powered chatbot designed to simplify tax compliance for millions of Kenyans.
In this detailed guide, we will walk you through the exact procedure for filing your returns via WhatsApp, highlight the benefits of using this method, and answer the most frequently asked questions. By the end of this article, you will be able to file your tax return in less than five minutes from the comfort of your phone.
What is KRA’s "Shuru" WhatsApp Chatbot?
"Shuru" is a conversational AI assistant launched by KRA to bridge the gap between complex tax systems and ordinary taxpayers. Unlike the heavy iTax web portal, Shuru lives inside WhatsApp—an application already installed on 99% of smartphones in Kenya.
Using the official number 0711 099 999 (or +254 711 099 999), taxpayers can initiate a chat, verify their identity, and file their income tax returns without filling out lengthy forms manually. The bot pulls pre-filled data from your employer and financial institutions, making the process nearly automatic.
Key Features:
24/7 Availability: File your returns at midnight or on a Sunday.
Multi-lingual Support: The bot can communicate in English and Swahili.
Secure: Uses OTP (One-Time Password) verification sent to your registered mobile number.
Step-by-Step Procedure: Filing KRA Returns on WhatsApp
If you are a salaried employee (resident individual with income from employment, interest, dividends, or rent), you are eligible to use this method. Here is the exact procedure to follow.
Step 1: Save the Official KRA Number
Open your WhatsApp application. Save the number 0711 099 999 (or +254 711 099 999) to your phone’s contacts. Warning: Criminals may try to impersonate KRA. Ensure the contact name clearly says "KRA Official" to avoid phishing scams.
Step 2: Start the Conversation
Open the chat with this number. To wake the chatbot, type "Hi" or "Hello" and send it. The bot will instantly reply with a menu of services.
Step 3: Select "File Tax Returns"
The bot will present you with a numbered list of options (e.g., 1. File Tax Returns, 2. Get Tax Compliance Certificate, 3. eTIMS Services, 4. Check PIN status). Reply with the number corresponding to "File Tax Returns" (usually number 1 or 2 depending on the menu update).
Step 4: Identity Verification (PIN & ID)
The chatbot will ask you to enter your KRA PIN (e.g., A001234567X). Type it exactly as it appears on your KRA card. Next, it will ask for your National ID Number or Passport number. Enter this correctly.
Step 5: One-Time Password (OTP) Verification
KRA will send a 6-digit OTP to the mobile phone number registered in the iTax system. Do not close the chat. Check your SMS inbox, retrieve the code, and type it into the WhatsApp chat. This confirms you are the owner of the account.
Step 6: Review Pre-Filled Information
This is the most important step. For salaried individuals, KRA has likely already received your income data from your employer (PAYE), your bank (interest), and the Ministry of Health (SHIF deductions).
The chatbot will display a summary of:
Total Gross Employment Income
PAYE Deducted
SHIF (Social Health Insurance Fund) Contributions
Housing Levy Deductions
Read this summary carefully. If you only worked one job and have no rental or business income, verify that the figures match your payslip.
Step 7: Declare Additional Income (If Any)
The bot will ask: "Do you have any other income (e.g., rental, business, or consultancy) not listed above?"
Reply "No" if you are strictly a salaried employee.
Reply "Yes" if you have side hustles, rental properties, or freelance work. The bot will guide you to enter those amounts manually.
Step 8: Submit Your Return
Once you confirm that the data is accurate, the bot will prompt you to send a final confirmation—usually by typing "YES" or "CONFIRM."
Within 30 seconds, you will receive a "Return Receipt" or "Acknowledgement Receipt" message. Screenshot this receipt immediately. It serves as proof that you filed before the June 30th deadline.
Benefits of Filing via WhatsApp vs. iTax Portal
Why should you switch from the desktop portal to WhatsApp? Here are the undeniable advantages.
1. Extreme Speed (Under 5 Minutes)
The average filing time on iTax is 15-20 minutes due to slow loading times and forgotten passwords. On WhatsApp, because the data is pre-filled, the process takes less than 5 minutes. For experienced users, it takes under 90 seconds.
2. No Password Resets Required
One of the biggest frustrations with iTax is the complex password requirement (uppercase, lowercase, special characters, numbers). The WhatsApp bot bypasses this entirely. You only need your PIN and ID, plus the SMS OTP.
3. Mobile-First Design
Over 80% of Kenyans access the internet via smartphones. While iTax is clunky on a small screen, WhatsApp is natively built for mobile. Buttons are large, text is readable, and you don't need to pinch-zoom to click a "Submit" button.
4. Automatic Computation of Tax Payable
The bot calculates your tax instantly. If you overpaid through PAYE, it will tell you exactly how much refund you are owed. If you owe extra (due to rental income), it will calculate the exact KRA bill immediately.
5. It's Free (Except Data Costs)
KRA does not charge for this service. Standard WhatsApp data charges apply (which are typically negligible on Safaricom, Airtel, or Telkom bundles). Unlike third-party tax agents who charge Kes. 500 - 1,000 to file for you, the WhatsApp method is 100% free.
6. Built-in Reminders
If you save the number, you can opt-in to receive reminders. KRA uses the channel to send nudges as the June 30th deadline approaches, ensuring you never file late and incur penalties.
Other Services Available on the KRA WhatsApp Number
The "Shuru" bot is not only for filing annual returns. You can use the same number 0711 099 999 for several other critical services without ever visiting a KRA office.
1. Tax Compliance Certificate (TCC)
Need a TCC to bid for a government tender or apply for a loan? Reply with the option for "Tax Compliance Certificate." The bot checks your filing history. If you are compliant, it generates and sends a PDF of your TCC directly to WhatsApp.
2. eTIMS Invoicing for Business Owners
Small business owners can register eTIMS via WhatsApp. You can generate invoices, send them to customers, and record sales—all within the chat. This helps you avoid penalties for non-compliance with the digital tax stamp.
3. PIN Status Check
Before hiring a supplier or paying a freelancer, you should verify their KRA PIN. The bot allows you to enter a third party's PIN to confirm if it is valid and active.
4. Penalty & Interest Calculation
If you missed filing in previous years, you can ask the bot for your outstanding principal tax, penalties, and interest. It even calculates the total amount required to bring your account back to "Compliant" status.
5. Connect to a Human Agent
If the bot cannot answer your specific question (e.g., complex loss carry-forward issues), you can type "Agent" or "Human." During business hours (Monday to Friday, 8 AM - 5 PM), you will be connected to a live KRA support agent via WhatsApp chat.
Important Warnings and Security Tips
While the convenience is remarkable, scammers are quick to exploit new systems. Follow these rules strictly.
1. Use ONLY 0711 099 999
There are fake accounts on WhatsApp using KRA logos. Double-check the phone number. KRA will never use a personal phone number or an international number starting with +1 or +44.
2. KRA Will Never Ask for Your iTax Password
This is a golden rule. The WhatsApp bot only asks for your PIN, ID, and the SMS OTP. If anyone asks for your iTax login password (the one you use for the portal), it is a scam. Hang up or stop chatting immediately.
3. No "Filing Fees"
KRA does not charge you to file via WhatsApp. If the bot or an "agent" asks for M-PESA payment to process your return, block the number and report it to KRA via *222#.
4. Beware of "You have won" Messages
Scammers may send messages claiming you won a tax refund of Kes. 50,000 and need to send "processing fees" to M-PESA. KRA never asks for mobile money fees. Refunds are processed directly to your bank account or via e-Citizen.
Who Cannot Use the WhatsApp Method?
While the WhatsApp bot is powerful, it has limitations. You cannot use it for the following scenarios:
Corporate Tax (Company Returns): Limited companies, trusts, and partnerships must still use the iTax web portal.
VAT Returns: Value Added Tax filing requires detailed schedules and invoices that the WhatsApp interface cannot support.
Turnover Tax (ToT) for large businesses: While small ToT filers might manage, if you have multiple business streams, stick to iTax.
Amending a Filed Return: If you realize you made a mistake after submitting, you cannot correct it via WhatsApp. You must log into iTax to file an amended return.
Non-Individual Taxpayers: NGOs, clubs, and estates cannot use the consumer WhatsApp bot.
Troubleshooting Common Issues
"The OTP is not arriving."
Solution: Ensure the phone number you used to register for KRA (the one on your ID) is active. If you changed SIM cards, you must update your mobile number on the iTax portal first. Visit a KRA Huduma Centre or use iTax to update the contact info.
"The bot says my data is not pre-filled."
Solution: This happens if your employer has not submitted your monthly returns yet. Or, if you are self-employed, the bot has no data to pull. In this case, you will have to manually type your gross income and expenses. Alternatively, use the iTax portal for more complex manual entries.
"I lost my receipt after filing."
Solution: Re-open the WhatsApp chat with 0711 099 999 and type "Receipt." The bot will ask for your PIN and resend the last filed return acknowledgement to you.
"I am getting an error: PIN not found."
Solution: Did you type the prefix letter correctly? KRA PINs start with A, P, or E (e.g., A012345678W). Also, ensure there are no spaces. If it still fails, your PIN might be dormant or not registered for iTax.
Frequently Asked Questions (FAQs)
1. Is filing via WhatsApp legally accepted by KRA?
Yes. The acknowledgement receipt you receive via WhatsApp has the same legal weight as one generated from the iTax portal. KRA stores the return in their backend database immediately upon submission.
2. What is the deadline for filing?
The financial year ends on June 30th. You must file your individual income tax return by June 30th, 11:59 PM. Filing on WhatsApp counts as "on-time."
3. Can I file for my elderly parent or child (dependent)?
Yes. You can use your phone to file for them, provided you have their KRA PIN, ID number, and access to their registered mobile number for the OTP. The OTP will go to their phone, not yours, so you need to coordinate with them.
4. What happens if I file late?
Late filing attracts a penalty of 5% of the tax due or Kes. 1,000 (for nil filers), plus interest of 1% per month on any unpaid tax. The WhatsApp bot can show you these penalties if you missed previous years.
5. How do I know if my return was successfully filed?
You will receive a "Confirmation" message containing a "Return Receipt Number." Keep this number safe. You can also check the status by replying "Status" to the bot.
Step-by-Step Video Script Alternative (For Visual Learners)
If you prefer visual instructions, the process flows like this:
Open WhatsApp > New Chat > 0711 099 999
Type: Hello
Bot: "Welcome to KRA Shuru. Choose service."
You type: 1 (File Return)
You type: A12345678W (Your PIN)
You type: 12345678 (Your ID)
Check SMS for 123456 (OTP) > Type 123456
Bot: "Your income is Ksh 50,000. Is this correct?"
You type: Yes
Bot: "Do you have rental income?" You type: No
Bot: "Tax Payable: Ksh 0. File now?" You type: Yes
Bot: *"Return filed successfully! Receipt No: KRA/2026/789."*
Conclusion: Embrace the Digital Tax Era
The Kenya Revenue Authority has taken a massive leap forward by integrating tax filing into WhatsApp. For the average Kenyan employee, this removes the intimidation of tax season. It is fast, free, and secure.
Your Action Plan:
Save 0711 099 999 in your phone right now.
If you haven't filed for 2025, open the chat and file today.
Share this article with a colleague who still pays an agent to file simple nil returns—you might save them money.
Remember: Filing your return is not just a legal obligation; it is your contribution to national development. With the WhatsApp bot, there is no longer an excuse for late filing.
Disclaimer: This article is for informational purposes. While we strive for accuracy, tax laws may change. Always confirm with an official KRA source or tax professional for complex situations.
