Developer watching live data load after a successful Wix Velo API integration

How to Add Custom API Integrations with Wix Velo (Real Examples)

A Wix Velo API integration connects your Wix site to an outside service — a payment processor, a CRM, a live data feed — using Velo’s built-in Fetch API to send and receive data behind the scenes. Most integrations run through backend code rather than the page itself, which keeps API keys secure and avoids browser restrictions.

I get asked “can you connect my Wix site to X?” more than almost any other question. The honest answer is usually yes, but how it gets built matters more than most business owners realize. A poorly built integration exposes API keys or breaks the moment the outside service changes something. A well-built one just quietly works.

Here’s what’s actually happening under the hood, and what you should know before hiring someone to build one for you.

What Does “API Integration” Actually Mean on a Wix Site?

An API integration means your Wix site talks to another system automatically, without a person copying data back and forth manually. That “other system” could be a payment gateway, a shipping calculator, a CRM, or a live inventory feed from a supplier.

On a standard Wix site without Velo, you’re limited to whatever pre-built app integrations Wix or its app marketplace already offers. Velo removes that ceiling. According to Wix’s own developer documentation, the Fetch API lets your site’s code communicate directly with a service to access or manage data — which is exactly what makes custom integrations possible in the first place.

How Does a Velo API Integration Actually Work?

At a technical level, Velo uses a module called wix-fetch, which works similarly to the standard JavaScript Fetch API most web developers already know. It sends a request to an external service and receives data back, usually in JSON format — an eBay listing, a weather forecast, a shipping quote, whatever the integration needs.

Here’s the part that matters for a business owner evaluating a developer’s work: Wix’s documentation is explicit that requests involving authentication or API keys should run from backend code, not the page itself. That’s because frontend code is visible to anyone who opens their browser’s developer tools, and an exposed API key there is a real security risk.

Where Should the Code Actually Live?

This is the detail that separates a properly built integration from a fragile one. Velo organizes code into frontend (page) code and backend code, with backend files typically living in dedicated web modules. Sensitive operations — anything involving a private API key or authentication — belong in that backend layer, not on the page.

Wix’s official documentation on exposing APIs describes two mechanisms for this: HTTP functions, used on standard sites, and HTTP endpoints, used for apps built with the Wix CLI. Either way, the principle holds: your site’s frontend asks its own backend for data, and the backend handles the actual conversation with the outside API. That structure keeps your credentials hidden from anyone poking around in the browser.

Real Examples of What This Looks Like in Practice

Here are genuine, common patterns for Velo API integrations, based on how these builds actually work:

A live currency or unit converter. The site calls an external exchange-rate API in the backend, then displays the converted number on the page in real time, without ever exposing the API key to visitors.

A weather or location-based data widget. A backend function calls a weather service using a securely stored API key, then returns just the relevant data to the frontend for display.

Routing form leads to a CRM automatically. Instead of an owner manually copying contact form submissions into a CRM, a backend function sends that data to the CRM’s API the moment someone submits the form.

Pulling live shipping rates from a carrier. A backend function calls a shipping API with the order’s weight and destination, then displays an accurate rate to the customer before checkout.

Each of these follows the same underlying pattern: sensitive logic and credentials stay on the backend, and only the finished result reaches the visible page.

Where I See Integrations Actually Go Wrong

Here’s an original point most guides for business owners skip entirely: the most common mistake isn’t a broken integration — it’s an insecure one that technically works. I’ve seen sites where an API key was hardcoded directly into frontend page code because it “worked fine” in testing. It worked fine right up until someone opened dev tools and found the key sitting in plain text.

Wix’s Secrets Manager exists specifically to prevent this, letting you store API keys securely and reference them from backend code without exposing them anywhere a visitor can see. If a developer quotes you for an integration and doesn’t mention where your API keys will actually live, that’s worth asking about directly before the project starts.

[INSERT: a real integration example here — e.g., a specific client’s API integration you built, what service it connected to, and what problem it solved for their business]

What Should You Ask a Developer Before They Build One?

Before hiring anyone for a custom Velo integration, ask these directly:

  1. Will API keys be stored in the Secrets Manager, or hardcoded somewhere visible?
  2. Will sensitive calls run through backend code, not the page itself?
  3. What happens if the external API changes or goes down? A good integration should fail gracefully, not break your entire page.
  4. How will you test this before it goes live? A quick demo with real data, not just a description of the plan.

If a developer can’t answer these clearly, that’s a real signal to keep looking. I’ve written more broadly about vetting Velo developers in what to check before you hire a Wix Velo developer, which covers the hiring side of this decision in more depth.

What Does This Actually Cost?

Simple integrations — a single external data feed displayed on a page — often run a few hundred dollars in development time. More involved integrations, like two-way CRM syncing or multi-step API workflows, can run into the low thousands, depending on how many edge cases need handling.

If you want a realistic number for your specific integration before requesting quotes, my website cost calculator gives you a grounded starting estimate.

Is Every “Integration” Request Actually Custom Work?

Not always, and it’s worth checking before you pay for custom development. Some connections you’re imagining already exist as pre-built Wix apps in the marketplace. I’ve covered this broader decision in when you actually need a Wix Velo developer — always worth a quick check before assuming custom code is required.

Frequently Asked Questions

What is a Wix Velo API integration?
It’s a custom connection between your Wix site and an external service, built using Velo’s Fetch API, allowing data to move automatically between the two without manual entry.

Is it safe to store API keys in Wix Velo?
Yes, when done correctly. Wix’s Secrets Manager lets you store API keys securely and reference them from backend code, keeping them hidden from anyone viewing your site’s frontend.

Do all API integrations need custom Velo code?
No. Many common connections already exist as pre-built apps in Wix’s app marketplace. Custom Velo code is needed when no existing app covers your specific requirement.

Why should API calls run from backend code instead of the page itself?
Frontend code is visible in a browser’s developer tools, so any API key or sensitive logic placed there can be exposed. Backend code keeps that information hidden from site visitors.

How much does a custom Wix Velo API integration cost?
Simple integrations typically cost a few hundred dollars, while more complex, multi-step integrations can run into the low thousands, depending on the number of systems involved.

Can a Wix Velo integration connect to any external service?
Generally yes, as long as the external service offers an API. The specific implementation depends on that service’s documentation and authentication requirements.

Want a Straight Answer on Your Specific Integration?

If you have a specific system you want your Wix site connected to, message me on WhatsApp and I’ll tell you honestly what it would take to build. Start the conversation here.