API integration explained for non-developers, with examples

An API integration is software that moves data between two systems automatically, using the requests each system publishes. How it works, with examples.

By Sohail Hussain16 November 20265 min read

An API integration is a small piece of software that moves data between two of your systems automatically, so nobody has to copy it by hand. An API (application programming interface) is the published list of requests a system accepts, such as "create a contact", "list today's orders" or "mark this invoice as paid". An integration uses the APIs of two systems to pass information from one to the other when something happens: a website enquiry becomes a lead in your CRM, a paid order becomes an invoice in your accounting software, a dispatched order triggers a WhatsApp message to the customer.

Connecting business systems this way is what our APIs and integrations service does. This guide explains the moving parts, so you can judge a proposal or a quote without needing to write code.

What is an API, in plain terms?

An API is a contract. The system promises: send a request in this exact format, and you will get this kind of answer back.

Each request goes to a specific web address, called an endpoint, over HTTPS. It says what it wants, proves who is asking with a key or token, and gets a reply. The reply is usually JSON: structured text where every value is labelled, such as "customer_name", "total" and "due_date". Ask an accounting system for an invoice and you get the customer, line items, tax and total as labelled fields. If you want to see what one looks like, paste a sample into our JSON formatter and it becomes readable.

APIs have versions. Vendors add new ones and retire old ones on a published schedule, which is one reason integrations need looking after.

What does an integration actually do?

Every integration repeats the same five steps: notice that something happened, fetch the details, translate them into the other system's format, send them, and record whether it worked. Some common examples:

When this happensData comes fromAnd goes toWhat moves
A website enquiry is submittedWebsite formCRMContact, message, source page, campaign
An online order is paidStore or payment gatewayAccountingInvoice, payment, tax lines
An order is dispatchedOrder systemWhatsAppA template message with the tracking link
A deal is wonCRMProject or job toolNew project with the client's details
Stock changesAccounting or ERPOnline storeAvailable quantity per product

Each of these has its own guide: website forms to CRM, the WhatsApp Business API and Tally and Zoho Books integrations.

How does one system know something happened in another?

There are three ways, and the choice decides how fast data moves and how much it costs to run.

MethodHow it worksTypical delayGood for
PollingThe integration asks every few minutes, "anything new?"MinutesSystems that cannot send notifications
WebhookThe source system calls your integration the moment something happensSecondsPayments, messages, form submissions
File exchangeOne system exports a file on a schedule; the other imports itHoursOlder software with no API

Webhooks are the modern default, and webhooks explained covers how they work and how to receive them safely. Polling still has its place, but every check uses up part of the API's request allowance.

What makes an integration harder than it looks?

Field mapping. Systems disagree about what a customer is. One has a single name field, another wants first and last names. One stores phone numbers with the country code, another without. One uses state names, another needs GST state codes. Most of the work in an integration is agreeing these translations, field by field.

Limits. APIs cap how many requests you can make. As of October 2026, the Zoho Books API allows 100 requests per minute per organisation and between 1,000 and 10,000 a day depending on the plan, according to its API documentation. A sync that ignores limits stops halfway through month-end, which is exactly when volume peaks.

Access. Tokens expire and have to be refreshed. If the connection was authorised with an employee's personal account and that person leaves, the integration can stop the day their account is closed.

Duplicates and order. The same event can arrive twice, or two events can arrive in the wrong order. A well-built integration recognises a repeat and does not create a second invoice.

Failures. The other system goes down for maintenance, or rejects a record because a field is missing. A good integration retries and tells a person. A bad one drops the record silently, and you find out from a customer. Why integrations break covers the habits that prevent this.

Should you use a connector tool or custom code?

Check first whether the two systems already connect natively. Many vendors offer ready-made integrations with popular tools, and a native one is usually the cheapest to run.

If not, connector tools such as Zapier, Make and n8n are good for simple, low-volume flows and can be set up in an afternoon. Custom code is better when volume is high, the mapping is complicated, one system has no connector, or failures must be caught and handled properly. Zapier vs Make vs n8n vs custom code compares them with prices. And when you find yourself connecting four tools with a spreadsheet in the middle, the question becomes whether you need a different tool altogether, which custom software vs off-the-shelf helps you decide.

What should you ask before commissioning one?

  1. Which system is the source of truth for each piece of data? Customers might belong to the CRM and invoices to accounting.
  2. Which direction does data move? One-way is simple. Two-way sync of the same record is several times harder, because both sides can change it.
  3. How fast does it need to be? Seconds, minutes or overnight each lead to a different design.
  4. What happens when it fails, and who is told?
  5. Whose accounts hold the keys and the connector subscription? They should be company accounts, not a developer's.
  6. What does it cost to run each month, including connector fees, hosting and any per-message or per-request charges?
  7. Who maintains it when a vendor changes its API?

Write the answers to those seven questions on one page before asking anyone for a quote. It turns a vague "connect our CRM to accounting" into something a developer can price accurately, and it often reveals that half the problem is a decision about data rather than code.

Was this guide useful?

Questions

Frequently asked.

Does every piece of software have an API?

Most cloud software does; look for developer or API documentation on the vendor's site. Desktop and older systems often have none, or a limited one. TallyPrime, for example, runs on your own computer and accepts XML or JSON requests over your local network rather than offering a cloud API. Without an API, integrations fall back to scheduled exports, email parsing or database access.

How long does an API integration take to build?

A one-way connection between two cloud systems with good APIs usually takes a few days to two or three weeks of developer time, including error handling and testing. Two-way sync, older systems without APIs and heavy data mapping take longer. A connector tool can be faster to start but adds a monthly fee per task or run.

Is it safe to give an integration access to our systems?

It is, if access is kept narrow. Create a separate integration user, grant only the permissions the integration needs, store keys in a secrets manager rather than in code or spreadsheets, and log every action it takes. When someone leaves, check whether the connection was authorised with their personal account.

Sohail Hussain

Founder, MSH Technologies

Sohail has designed and built websites, web apps and AI products for over 12 years, for clients from Singapore-based industrial groups to early-stage SaaS startups. He writes about what actually worked.

Keep reading

Related guides.

All posts

Your next move

Like what you see? Tell us about it.

A process that takes too long, a website that undersells you, or an idea ready to take shape. Tell us where you are and we will suggest a useful next step.

India · Working with clients worldwide

Sohail, Founder, replies within 1 working day (Mon–Sat, IST). Free and no obligation.