Bolt.new AI and Wave integration: Step-by-Step Guide 2025

To integrate Bolt.new AI with Wave, you don’t connect “Bolt-to-Wave” directly. Instead, you build a small full‑stack app inside bolt.new, and that app communicates with the Wave API using Wave’s official REST endpoints with an API key stored as an environment variable in Bolt. Bolt.new itself is just your development workspace; the real integration happens in your backend code (Node.js/Express or similar) where you call Wave’s API over HTTPS.

 

What “integration” actually means here

 

Wave (the accounting platform at waveapps.com) exposes a GraphQL API for invoices, customers, products, and payments. It uses Bearer Token authentication — meaning you generate an API Key in Wave, then send requests with an Authorization: Bearer YOUR\_TOKEN header.

Bolt.new is where you write, run, and test the code that calls Wave. You store the Wave API key inside Bolt’s environment vars, then call Wave’s GraphQL endpoint from your API route. Bolt never “auto-connects” — your code performs the integration.

 

Step-by-step: How to integrate Bolt.new with Wave

 

• Create a backend route in Bolt (Node/Express) that talks to Wave’s GraphQL API.
• Add your Wave API key into Bolt.new environment variables (for example: WAVE_API_KEY).
• Use fetch or Axios from your backend route to call Wave’s endpoint.
• Return data to your frontend UI components inside Bolt.

Wave’s GraphQL Endpoint is:

https://gql.waveapps.com/graphql/public

 

Minimal working example: fetch a list of businesses from Wave

 

// This is an Express route inside your Bolt.new backend
// Make sure you have WAVE_API_KEY set in your Bolt environment variables

import express from "express";
import fetch from "node-fetch";

const router = express.Router();

router.get("/wave/businesses", async (req, res) => {
  try {
    const query = `
      query {
        businesses {
          edges {
            node {
              id
              name
            }
          }
        }
      }
    `;

    const response = await fetch("https://gql.waveapps.com/graphql/public", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${process.env.WAVE_API_KEY}` // required auth header
      },
      body: JSON.stringify({ query })
    });

    const data = await response.json();
    res.json(data); // Send to frontend
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
});

export default router;

 

Frontend example inside Bolt.new (simple fetch)

 

// A React component inside Bolt to call your backend route

import { useEffect, useState } from "react";

export default function WaveBusinesses() {
  const [businesses, setBusinesses] = useState([]);

  useEffect(() => {
    fetch("/api/wave/businesses")
      .then(res => res.json())
      .then(data => {
        const items = data?.data?.businesses?.edges || [];
        setBusinesses(items);
      });
  }, []);

  return (
    <div>
      <h3>Wave Businesses</h3>
      <ul>
        {businesses.map(b => (
          <li key={b.node.id}>{b.node.name}</li>
        ))}
      </ul>
    </div>
  );
}

 

Important notes

 

• Wave uses GraphQL only — no REST endpoints.
• Your API key must stay server-side; do not call Wave directly from frontend JS.
• Bolt.new sandbox supports standard Node fetch, so no special SDK required.
• For production, move this backend code to your real server with proper environment variable management.

In short: Bolt.new doesn’t “integrate” with Wave itself. You write a backend API route in Bolt that uses Wave’s GraphQL endpoint with a Bearer token. That’s the actual integration.