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

To integrate bolt.new with Amplitude, you simply send events from your bolt.new backend (or frontend) to Amplitude’s HTTP API using your Amplitude API key. Bolt doesn’t have a special “Amplitude integration” button — you wire it yourself using standard REST calls. In practice, you store your Amplitude API key as an environment variable inside bolt.new, then call Amplitude’s HTTP V2 Ingestion API every time something meaningful happens in your app (user action, page view, AI request, etc.). This works reliably inside bolt.new because it supports outbound HTTPS requests.

 

What You Actually Do

 

You implement a tiny analytics helper inside your bolt.new backend that sends JSON payloads to Amplitude’s ingestion endpoint. The workflow is exactly the same as in any Node.js environment: get the key from env vars, build a POST request, send it, check the response. That’s it.

 

The Steps, Explained Simply

 

• Create an Amplitude project inside Amplitude → get your “API key” (sometimes called “API Key” or “Project API Key”).
• Store the API key in bolt.new environment variables. In bolt.new, open the environment panel → add for example: AMPLITUDE_API_KEY=your-key-here This prevents hardcoding secrets into your code.
• Create a small server-side API route in your bolt.new project (typically using Node/Express or the built‑in server template).
• Send events to Amplitude using the HTTP V2 API: URL: https://api2.amplitude.com/2/httpapi Method: POST Body: JSON with your API key and events.
• Call your tracking helper from anywhere in your app (backend routes, frontend actions hitting backend endpoints, or AI-tool actions).

 

Minimal Working Example (Node.js inside bolt.new)

 

// analytics/amplitude.js
// Small helper for sending events to Amplitude from bolt.new

import fetch from "node-fetch"

const AMPLITUDE_API_KEY = process.env.AMPLITUDE_API_KEY

export async function trackAmplitudeEvent(userId, eventName, eventProps = {}) {
  if (!AMPLITUDE_API_KEY) {
    console.error("Missing AMPLITUDE_API_KEY environment variable")
    return
  }

  const payload = {
    api_key: AMPLITUDE_API_KEY,
    events: [
      {
        user_id: userId,         // A unique user identifier you choose
        event_type: eventName,   // Like "button_clicked"
        event_properties: eventProps
      }
    ]
  }

  const res = await fetch("https://api2.amplitude.com/2/httpapi", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(payload)
  })

  if (!res.ok) {
    console.error("Amplitude error:", await res.text())
  }
}

 

// api/track.js
// Example bolt.new backend route that tracks an event

import { trackAmplitudeEvent } from "../analytics/amplitude.js"

export default async function handler(req, res) {
  const { userId, eventName, props } = req.body

  await trackAmplitudeEvent(userId, eventName, props)

  res.json({ status: "ok" })
}

 

How to Trigger Events

 

• From frontend: call your /api/track endpoint whenever a user interacts.
• From backend: call trackAmplitudeEvent(...) directly.
• From AI actions inside bolt.new: have the agent hit the backend route (bolt agents can call your HTTP routes).

 

Important Notes

 

• Never send the Amplitude API key from frontend code. Keep it server‑side only.
• Amplitude tolerates fast prototyping. Even sloppy events work; you can refine schema later.
• Bolt.new allows outbound HTTPS, so the REST API works without additional configuration.
• No SDK needed. Using the REST API is simpler and fully supported.

 

Summary

 

You integrate bolt.new with Amplitude by calling Amplitude’s REST ingestion API from bolt.new’s backend, using an environment variable to store the API key. You create a tiny helper function to send analytics events, expose a server route if needed, and call it whenever something happens in your app. This is the cleanest and most realistic way to wire analytics inside bolt.new.