Fundamentals

API Integration Explained: How to Connect Your Business Tools

Understanding and using APIs - even without coding skills. With practical examples.

12 min read

APIs are the backbone of modern automation. But what exactly is an API? And how do you use them to connect your tools? In this article, we explain API integration without programmer jargon – and show you how to get started right away.

What is an API?

API stands for "Application Programming Interface."

A simple analogy: Imagine a restaurant.

  • You are the customer (your automation)
  • The kitchen is the system (e.g., your CRM)
  • The waiter is the API

You tell the waiter what you want ("I'd like the customer data for Company XY"). The waiter goes to the kitchen, gets the data, and brings it to you – in a format you understand.

Without an API: You'd have to go into the kitchen yourself and know where everything is. With an API: You simply ask and get what you need.

Why APIs Matter for Automation

Without APIs you would need to:

  • Copy data manually
  • Send CSV files back and forth
  • Use screen scraping (fragile)
  • Write directly to databases (dangerous)

With APIs you can:

  • Synchronize data in real-time
  • Trigger actions in other systems
  • Automatically retrieve information
  • Securely connect systems

Example:

Without API: Export your Shopify orders as CSV every day and manually import them into your accounting tool.

With API: Every order is automatically and immediately transferred to the accounting tool.

API Basics Explained Simply

Endpoint

The "address" of a specific function.

https://api.hubspot.com/crm/v3/contacts

This endpoint returns contacts from HubSpot.

Request

What you want from the API. There are different types:

MethodMeaningExample
GETRetrieve dataFetch list of all customers
POSTCreate dataCreate new contact
PUT/PATCHUpdate dataChange phone number
DELETEDelete dataRemove contact

Response

What the API returns – usually in JSON format:

{

"id": "12345",

"name": "John Smith",

"email": "john@company.com",

"company": "Acme Inc."

}

Authentication

How you prove you're allowed to access:

MethodDescriptionExample
API KeySimple key?api_key=abc123
Bearer TokenToken in headerAuthorization: Bearer xyz789
OAuth 2.0Complex, more secureLogin process with redirect

Rate Limits

How often you can call the API:

  • HubSpot: 100 requests/10 seconds
  • Shopify: 2 requests/second
  • Slack: 1 request/second

Exceeding = temporary block.

API Integration Without Programming

You don't need to know how to code to use APIs. No-code tools handle that for you:

How Make.com Uses APIs

[Trigger: New order in Shopify]

Make.com calls Shopify API (GET order)

Make.com calls HubSpot API (POST contact)

Make.com calls Slack API (POST message)

You only configure: "If X, then Y" – Make.com handles the API calls.

How n8n Uses APIs

Same principle, but with more control:

  • Pre-built nodes for 400+ apps
  • HTTP node for any API
  • Code node for complex logic

How Zapier Uses APIs

The simplest approach:

  • Select App A and App B
  • Choose trigger and action
  • Zapier takes care of the rest

Step-by-Step: Your First API Integration

Example: New Form Entries to HubSpot

Goal: When someone fills out a Typeform, a contact is automatically created in HubSpot. In Make.com:
  • Create new scenario
  • Add trigger:
  • - App: Typeform

    - Event: "Watch Responses"

    - Connect your Typeform account

  • Add action:
  • - App: HubSpot

    - Action: "Create a Contact"

    - Connect your HubSpot account

  • Map fields:
  • Email: {{typeform.email}}

    First Name: {{typeform.firstname}}

    Last Name: {{typeform.lastname}}

    Company: {{typeform.company}}

  • Activate
  • Done. Every new Typeform response now creates a HubSpot contact.

    Common API Integration Scenarios

    1. CRM <-> Email Marketing

    HubSpot <──> Mailchimp
    
    
    • New HubSpot contact → Mailchimp subscriber
    • Mailchimp click → HubSpot activity
    • HubSpot deal won → Change Mailchimp tag

    2. E-Commerce <-> Accounting

    Shopify <──> QuickBooks
    
    
    • New order → Create invoice
    • Payment received → Mark invoice as paid
    • Cancellation → Create credit note

    3. Support <-> CRM

    Zendesk <──> Salesforce
    
    
    • New ticket → Salesforce case
    • Ticket closed → Salesforce update
    • VIP customer → Increase ticket priority

    4. Project Management <-> Communication

    Asana <──> Slack
    
    
    • Task created → Slack message
    • Task due → Reminder in Slack
    • Task completed → Notify team channel

    5. Forms <-> Database

    Typeform <──> Airtable
    
    
    • Form filled out → New Airtable record
    • Enriched with data (Clearbit)
    • Status tracking in Airtable

    Making Your Own API Calls (HTTP Request)

    Sometimes there's no pre-built integration. Then you use HTTP requests directly.

    In Make.com: HTTP Module

    Example: Query Weather API
  • Add HTTP module
  • Configure:
  • URL: https://api.openweathermap.org/data/2.5/weather

    Method: GET

    Query Parameters:

    - q: Berlin

    - appid: YOUR_API_KEY

    - units: metric

  • Use response:
  • {

    "main": {

    "temp": 18.5,

    "humidity": 65

    },

    "weather": [{"description": "cloudy"}]

    }

    In n8n: HTTP Request Node

    Same logic, different interface:

    • Configure URL, Method, Headers, Body
    • Parse response
    • Use in subsequent nodes

    Common Problems and Solutions

    Problem: "401 Unauthorized"

    Cause: Wrong or expired API key Solution:
    • Check API key (typos?)
    • Refresh token (OAuth)
    • Check permissions in API dashboard

    Problem: "429 Too Many Requests"

    Cause: Rate limit exceeded Solution:
    • Build in delays between requests
    • Batch processing instead of individual calls
    • Retry with exponential backoff

    Problem: "500 Internal Server Error"

    Cause: Problem at the API provider Solution:
    • Check provider's status page
    • Try again later
    • Build in error handling

    Problem: Data Not Arriving

    Cause: Wrong data format Solution:
    • Read API documentation
    • Check request body (JSON syntax)
    • Verify required fields

    Best Practices for API Integration

    1. Build in Error Handling

    What happens when the API is unreachable?

    Try: API call
    

    Catch:

    - Log

    - Retry after 5 minutes

    - After 3x failure: Send alert

    2. Enable Logging

    Record:

    • When was what sent
    • What came back
    • Where were there errors

    3. Protect Sensitive Data

    • Don't store API keys in plain text
    • Use HTTPS
    • Grant minimal permissions

    4. Respect Rate Limits

    • Build in delays
    • Use bulk operations where possible
    • Cache frequent queries

    5. Maintain Documentation

    • Which integration does what
    • Which fields are mapped
    • Who is responsible

    Useful API Resources

    Finding API Documentation

    Most SaaS tools have public API docs:

    • docs.hubspot.com/api
    • developer.shopify.com
    • api.slack.com

    API Testing Tools

    • Postman: Test APIs before integrating
    • Insomnia: Similar to Postman, open source
    • RapidAPI: API marketplace

    Webhook Testing

    • Webhook.site: Test incoming webhooks
    • RequestBin: Inspect requests

    Conclusion

    APIs are not rocket science. They're standardized ways for software to talk to each other. With no-code tools like Make.com or n8n, you can use APIs without writing a single line of code.

    The key is:

  • Understand the principle (Request → Response)
  • Use pre-built integrations where possible
  • Learn HTTP requests for special cases
  • Build in error handling
  • Most of your tools have APIs. Use them.


    Want to connect your systems but find the API documentation confusing? We build your integrations – from simple synchronization to complex data pipelines.

    Questions About Automation?

    Our experts will help you make the right decisions for your business.