All articles
POS & Billing7 min read

Connecting iCount to AI Agents and Automations: A Developer's Honest Guide

iCount runs the books for a huge share of Israeli freelancers and small businesses, and almost all of them are sitting on financial data that an AI agent could put to work. The good news: iCount has a real REST API. The honest news: it behaves like an accounting API from a certain era, and knowing its quirks before you build saves you a lot of pain.

Most automation projects I'm hired for start the same way: a business owner has years of invoices, receipts, and client records living in iCount (איקאונט), and they want an AI layer on top - something that reads, summarizes, reconciles, or replies. Before promising anything, I always check how the system actually exposes its data. With iCount, the answer is encouraging but specific.

How iCount actually exposes data

iCount offers a genuine REST API, returning JSON. There are effectively two generations of it living side by side. The older one accepts your company id, user, and password as parameters on every request to PHP-style endpoints. The newer v3 API (api-v3.icount.co.il) is cleaner: you authenticate once to get a session token (sid), or use an issued API token as a Bearer header, then call resource groups like documents and clients.

A few things matter a lot in practice, and I'd rather you hear them up front than discover them in production:

  • Auth is credential- or token-based, not OAuth - so you store secrets server-side and rotate them carefully. Never put iCount credentials in a browser or a public no-code step.
  • Every response carries a status/error field. iCount can return HTTP 200 with an error inside the body, so you check the payload, not just the status code.
  • There's a rate limit around 30 requests per minute. That's fine for events, fatal for naive bulk loops. You batch and back off.
  • There is no robust public webhook system for 'new invoice' or 'payment received'. This is the single biggest architectural fact: in most cases you poll on a schedule rather than getting pushed events.
The question is never 'does iCount have an API' - it does. The real question is 'is it push or pull', and for iCount the honest answer is pull. Design for polling and you'll build something stable.

What you can actually build

Once you accept the poll-and-token model, a lot opens up. These are integrations I've either built or scoped for real clients:

  1. Invoice intake: an AI agent reads incoming supplier PDFs from email or Drive, extracts vendor, amount, VAT and date, and creates a matching expense document in iCount via the API - with a human approving anything below a confidence threshold.
  2. WhatsApp/email assistant grounded in real data: a customer asks 'did my payment go through' and the bot queries the relevant iCount document instead of hallucinating, answering from the actual record.
  3. Reconciliation and anomaly alerts: a nightly job pulls recent documents, an LLM flags duplicates, suspicious round numbers, or a client whose unpaid balance crossed a threshold, and posts a Hebrew summary to Slack.
  4. Monthly close summaries: pull the period's documents, let the model write a plain-language revenue/VAT recap for the owner and the accountant.
  5. Lead-to-invoice automation: when a deal closes in your CRM, generate and send the iCount invoice automatically, then log it back to the CRM.

No-code (Make/Zapier) vs. custom code

I'm not precious about writing code where it isn't needed. If your volume is low, your logic is simple, and a connector exists, a Make or Zapier scenario calling the iCount API directly is often the right, cheap answer - you can prototype the invoice-creation flow in an afternoon.

You move to custom code when one of these is true: volume pushes you past the rate limit and you need real queuing and back-off; you're sending financial data to an LLM and privacy/PII handling has to be airtight; the logic is genuinely complex (multi-step reconciliation, confidence gating, Hebrew text parsing); or there's simply no connector for the exact iCount endpoint you need and you must call it raw. Most serious projects end up as a thin, well-tested service that owns the iCount and AI calls, with the no-code tool reduced to a trigger - or removed entirely.

If you're a business owner reading this and thinking 'I want to connect my existing systems to AI but I don't want to hand my financial data to something flaky,' that's exactly the work I do. I build the iCount integration end to end - secure credential handling, sensible polling, the AI layer that adds judgment, and a human-in-the-loop where money is involved. If you'd like to hire a developer to connect iCount to AI agents and automations properly, get in touch through the contact form below and tell me what you're trying to automate - I'll tell you honestly whether it's a no-code afternoon or a real build.

Looking for a developer to connect your systems to AI?

I'm Ariel Gelberg — a senior software engineer and technical partner. I build the integrations and automations that connect your business to AI, end to end.

Let's talk