Installation

Overview

Install the Reponse SDK with your preferred package manager, configure your API key, and verify the setup with a quick health check. The entire process takes under five minutes.

Prerequisites

• Node.js 18 or later
• A package manager: npm, pnpm, or yarn
• A Reponse API key (see Authentication)

Step 1 — Install the SDK

Choose your package manager:

# npm
npm install @reponseai/sdk

# pnpm
pnpm add @reponseai/sdk

# yarn
yarn add @reponseai/sdk

For React projects, also install the hooks package:

npm install @reponseai/react

CDN (Browser)

If you are not using a bundler, load the SDK from the CDN:

<script src="https://cdn.reponse.ai/sdk/latest/reponse.min.js"></script>
<script>
  const reponse = new Reponse({ apiKey: "rp_live_..." });
</script>

Step 2 — Configure Environment Variables

Create a `.env.local` file at the root of your project:

# Required — your workspace API key (server-side only)
REPONSE_API_KEY=rp_live_...

# Optional — override the default API base URL
NEXT_PUBLIC_REPONSE_BASE_URL=https://api.reponse.ai

**Important:** Never prefix server-only secrets with `NEXT_PUBLIC_`. The `REPONSE_API_KEY` variable must stay server-side.

Step 3 — Initialize the Client

import { Reponse } from "@reponseai/sdk";

const reponse = new Reponse({
  apiKey: process.env.REPONSE_API_KEY!,
});

Step 4 — Verify the Installation

Run a quick products request to confirm everything works:

const { data } = await reponse.catalog.listProducts({ query: { limit: 1 } });
console.log("Connected ✓ — first product:", data.data[0]?.title);

Expected output:

Connected ✓ — first product: Example Product

Configuration Options

Troubleshooting