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

A Bolt.new AI project integrates with Spocket the same way any normal web app does: by calling the Spocket REST API from your Bolt backend, using an API token stored inside Bolt’s environment variables. Bolt itself does not have a built‑in Spocket connector. You wire it manually using HTTPS requests. The flow is: you get a Spocket API key (from their merchant dashboard), store it in Bolt’s env vars, create backend routes that call Spocket’s endpoints, and then use those routes from your Bolt front‑end or workflow. That’s it — normal API integration patterns.

 

How the integration actually works

 

Spocket exposes a real REST API for fetching products, variants, inventory, and pushing orders. Bolt.new gives you a sandboxed backend (usually a Node.js/Express server) where you can make outbound requests using fetch or axios. So your backend in Bolt acts as a middle layer between your UI and Spocket.

You never call Spocket directly from the front‑end because the API key must stay private. Instead, you store the key in Bolt’s Environment Variables, which prevents it from leaking into the browser.

• Spocket → Provides REST endpoints + API key auth.
• Bolt Backend → Secure server where Spocket API calls happen.
• Bolt Front-End → Calls your backend routes only.

 

Step-by-step: Set up authentication

 

Spocket uses a standard API key sent in the Authorization header. In Bolt.new you simply add an env variable, like:

• Key: SPOCKET_API_KEY
• Value: your real API key from Spocket dashboard

Then in backend code you reference process.env.SPOCKET_API_KEY.

 

Example backend route in Bolt (Node.js) that fetches Spocket products

 

This is a minimal, valid example showing the exact integration pattern you will use inside Bolt.new:

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

const router = express.Router();

router.get("/spocket/products", async (req, res) => {
  try {
    const response = await fetch("https://api.spocket.co/v1/products", {
      method: "GET",
      headers: {
        Authorization: `Bearer ${process.env.SPOCKET_API_KEY}`, // secure API key
        "Content-Type": "application/json"
      }
    });

    if (!response.ok) {
      return res.status(response.status).json({ error: "Failed to fetch Spocket products" });
    }

    const data = await response.json();
    res.json(data); // return data to your front-end
  } catch (err) {
    res.status(500).json({ error: "Server error", details: err.message });
  }
});

export default router;

 

How to call this from your Bolt front-end

 

In your front-end you just call your backend route. This keeps the secret API key protected.

async function loadProducts() {
  const res = await fetch("/api/spocket/products"); // hits your backend route
  const data = await res.json();
  console.log(data); // shows Spocket products
}

 

Adding order‑creation (example)

 

If you want to send an order to Spocket, you do the same pattern but with a POST request:

router.post("/spocket/order", async (req, res) => {
  try {
    const response = await fetch("https://api.spocket.co/v1/orders", {
      method: "POST",
      headers: {
        Authorization: `Bearer ${process.env.SPOCKET_API_KEY}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify(req.body) // must match Spocket payload format
    });

    const data = await response.json();
    res.json(data);
  } catch (err) {
    res.status(500).json({ error: "Order creation failed", details: err.message });
  }
});

 

Important integration notes

 

• Keep the API key in environment variables only. Never in client code.
• Check Spocket’s rate limits to avoid throttling.
• Use HTTPS only (Bolt does this automatically when deployed).
• Validate user inputs before sending order data to Spocket.

 

Summary

 

Integrating Bolt.new with Spocket is simply about connecting your Bolt backend to Spocket’s REST API using an API key. Once you store that key in environment variables, you make secure server-side calls to Spocket, expose your own clean routes for the front-end, and you now have a full working Spocket integration — products, inventory, and orders — all from a Bolt workspace.