What an API is, and why it decides whether you can automate your business
Explained without jargon and with what matters: why software without an API ties you down, what to ask a supplier before signing, and how to tell whether what you have today can be connected.
· Full-stack development
There is one question that decides whether a small business will ever be able to automate anything, and almost nobody asks it before buying software: does this have an API?
Let us take the mystery out of it, because it is not a difficult technical concept: it is a business concept with a technical name.
What it is, without jargon
An API is the door through which one program lets another program talk to it.
Your invoicing software has a screen so that you can create an invoice. If it also has an API, another system can create that invoice by itself, without anybody opening the screen. The same goes for reading, changing or listing.
The useful analogy: the screen is the counter for people; the API is the loading bay for machines. A warehouse with no loading bay can only take deliveries by hand, box by box.
Why this decides so much
Everything in your business that consists of taking a piece of data from one place and putting it into another — which is most administrative work — can only be automated if both ends have a door.
- Orders from the shop into the accounts.
- Bank movements into the management software.
- Recorded hours into the payroll.
- Contacts from the web form into the customer system.
If the program at one end has no API, a person does that chain by hand. Forever.
The alternatives when there is no API, and what they really cost
- Importing and exporting files. It works, and it is the usual route in accounting software, but it is manual and periodic: somebody has to export, check and import.
- Automating the screen. Programs that mimic a person clicking. It is brittle: any change to the layout breaks it, and it often goes against the terms of use.
- Changing software. Sometimes it is the cheapest option over two years, however much the migration hurts.
The five questions before buying software
This is the actionable part. Before signing up to any management, invoicing or accounting software:
- Is there a public, documented API? «Documented» means there is a page explaining how to use it. If they say yes but there is no documentation, the real answer is no.
- Is it included or charged separately? It is common for the API to sit on a higher plan. Find out before, not once you have three years of data inside.
- What limits does it have? Number of requests, permitted operations, accessible data. An API that only lets you read is no use for automating invoice entry.
- Can I export everything without the API? The fallback. Even if you never automate, your data has to be able to leave.
- How do they announce changes? APIs change. A serious supplier versions and warns in advance; one that does not breaks your integration on a Tuesday morning.
Those five questions, sent by email before signing, save years of manual work. And the answer — or the silence — tells you a lot about the supplier.
How to tell what you have today
A twenty-minute exercise: list the programs your business uses and search for «[program name] API» or «[name] developer documentation». In fifteen minutes you will know which of your tools can be connected and which ones have you tied down.
That map decides, more than anything else, what can be automated in your business this year.
Two warnings
An API existing does not make the integration trivial. You still have to decide which data goes where, what happens when it fails and how duplicates are avoided. We cover that in connecting your shop to your accounts.
An API is access to your data. Its keys have to be treated like passwords: kept in a manager, with the minimum permissions needed, renewable and revocable. A leaked API key gives access to everything that key allows, with no password and no second factor in the way.
If this sounds like you
Knowing what part of your operation can be connected today, at what effort and in what order is exactly what the process and AI audit does: it comes out with the map of your tools and the prioritised list. Building the integrations is custom development, and where to begin is in what to automate first.
We are Mindset & Code: automation, data and development for small businesses. You can see what we do and what it costs.
General guidance. Each product's API access terms are worth checking in its official documentation and its contract before buying.