Skip to content
Reponse.ai LogoDocs
DocsAPISDKsGuides

Search Documentation

Search for an article...

Getting Started

  • Overview
  • Architecture
  • Installation
  • Authentication
  • First Request

Products & Collections

  • Products — List
  • Products — Get
  • Products — Metafields
  • Collections — List
  • Collections — Get
  • Collections — Products

Cart & Checkout

  • Cart — Create
  • Cart — Get
  • Cart — Add Item
  • Cart — Update Item
  • Cart — Remove Item
  • Cart — Apply Promotion
  • Checkout — Stripe
  • Checkout — Payment Intent
  • Checkout — ACP

Orders & Fulfillment

  • Orders — Create
  • Orders — Get
  • Orders — Confirm
  • Orders — Cancel
  • Orders — Fulfill
  • Orders — Refund

Commerce

  • Inventory — Get
  • Inventory — Update
  • Shipping — Rates
  • Discounts — List
  • Discounts — Create
  • Discounts — Validate
  • Subscriptions — Manage

Loyalty & Gift Cards

  • Loyalty — Balance
  • Loyalty — Redeem
  • Loyalty — Referral
  • Gift Cards — List
  • Gift Cards — Redeem

Tickets & Support

  • Tickets — List
  • Tickets — Create
  • Tickets — Reply

Platform

  • Product Feed — JSON
  • Product Feed — CSV
  • Theme — Get
  • Approvals — Execute
  • Approvals — Reject
  • Geocode

SDKs

  • SDK Overview
  • TypeScript SDK
  • React Hooks

Guides

  • Chat Widget
  • Shopify Sync
  • Storefront Starter
  • Loyalty Program
  • Discounts & Promotions
  • Subscriptions
  • Klaviyo Integration
  • Custom Domains
  • Agentic Commerce (ACP)
  • A2A Protocol
  • AI Engines
  • MCP Server

Webhooks

  • Webhooks Overview
  • Events Reference
  • Shopify Webhooks
  • Stripe Webhooks
  • Reviews (Stamped / Trustpilot)
  • Logistics
  • Email Inbound

Resources

  • Environment Variables
  • Rate Limits
  • Changelog
DocsResourcesEnvironment Variables

Environment Variables

Environment variables used by the Reponse SDK and storefronts.

2 min read/Last updated Jul 9, 2026
On this page

Overview

Reponse uses environment variables to configure API keys, database connections, third-party integrations, and runtime behavior. This reference lists every variable, grouped by category. Never commit secrets to source control — use `.env.local` or your hosting provider's secrets manager.

Core (Required)

VariableDescription
NEXT_PUBLIC_SUPABASE_URLSupabase project URL. Exposed to the client for auth and realtime.
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEYSupabase anon/public key. Safe for client-side use.
SUPABASE_SERVICE_ROLE_KEYSupabase service role key. Server-only. Full database access.
OPENAI_API_KEYOpenAI API key for chat completions and embeddings.
NEXT_PUBLIC_BASE_URLPublic base URL of the app (e.g. https://reponse.ai).

SDK

VariableDescription
REPONSE_API_KEYWorkspace API key used by the SDK. Server-side only.
NEXT_PUBLIC_REPONSE_BASE_URLOptional API base URL override for the client SDK.

Storefront

These variables are specific to storefronts built with the [Storefront Starter](doc:storefront-starter) or the Reponse SDK.

VariableDescription
NEXT_PUBLIC_REPONSE_API_URLAPI base URL (e.g. https://reponse.ai/api).
NEXT_PUBLIC_REPONSE_API_KEYClient-side API key (same value as REPONSE_API_KEY). Used for client-side cart and variant operations.
NEXT_PUBLIC_WORKSPACE_IDWorkspace UUID. Found in the dashboard URL or Settings → General.
NEXT_PUBLIC_STORE_NAMEStore name displayed in the header and footer.
NEXT_PUBLIC_SITE_URLCanonical site URL for SEO (e.g. https://my-store.com).
NEXT_PUBLIC_MARKET_IDMarket UUID for currency, taxes, and shipping. Found in Dashboard → Settings → Markets.
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEYStripe publishable key (pk_live_ or pk_test_). Found in Stripe Dashboard → API Keys.
CHECKOUT_MODECheckout flow: embedded (Stripe Elements on your site) or redirect (Stripe-hosted page). Defaults to embedded.

Shopify

VariableDescription
SHOPIFY_WEBHOOK_SECRETHMAC secret for verifying Shopify webhook signatures.

Email (Resend)

VariableDescription
RESEND_API_KEYResend API key for transactional emails.
RESEND_FROM_EMAILDefault sender address (e.g. hello@reponse.ai).
EMAIL_FROM_DOMAINVerified sender domain for order and support emails.
DEFAULT_SENDER_DOMAINFallback sender domain when workspace has none configured.

Notion CMS

VariableDescription
NOTION_TOKENNotion integration token for CMS content fetching.
NOTION_DATABASE_IDMain Notion database ID.
NOTION_TOPICS_DATABASE_IDTopics database ID for doc/content pages.

Payments (Paddle)

VariableDescription
PADDLE_API_KEYPaddle API key for subscription billing.
NEXT_PUBLIC_PADDLE_ENVPaddle environment: sandbox or production.

Analytics

VariableDescription
NEXT_PUBLIC_GA4_MEASUREMENT_IDGoogle Analytics 4 measurement ID (client-side).
GA4_MEASUREMENT_IDGA4 measurement ID (server-side fallback).
GA4_API_SECRETGA4 Measurement Protocol API secret.

DNS & Hosting (Netlify)

VariableDescription
NETLIFY_ACCESS_TOKENNetlify API access token for custom domain management.
NETLIFY_SITE_IDNetlify site ID for DNS configuration.
NEXT_PUBLIC_NETLIFY_SITE_NAMENetlify site name for CNAME targets.

Security & Encryption

VariableDescription
CRYPTR_SECRET_KEYEncryption key for securing stored credentials (Shopify tokens, etc.).
CRON_SECRETSecret token for authenticating internal cron job requests.

SEO

VariableDescription
INDEXNOW_KEYIndexNow API key for search engine URL submission.

AI Models

VariableDescription
REVIEW_EMBEDDING_MODELEmbedding model for review vectors (default: text-embedding-3-small).
INBOX_AUTO_RESPONSE_MODELModel for auto-responding to support tickets (default: gpt-4o-mini).

Example `.env.local`

bash
# ── Core ──────────────────────────────────────────
NEXT_PUBLIC_SUPABASE_URL=https://xxxx.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=eyJ...
SUPABASE_SERVICE_ROLE_KEY=eyJ...
OPENAI_API_KEY=sk-...
NEXT_PUBLIC_BASE_URL=https://reponse.ai

# ── SDK ───────────────────────────────────────────
REPONSE_API_KEY=rp_live_...

# ── Shopify ───────────────────────────────────────
SHOPIFY_WEBHOOK_SECRET=shpss_...

# ── Email ─────────────────────────────────────────
RESEND_API_KEY=re_...
EMAIL_FROM_DOMAIN=reponse.ai

# ── Payments ──────────────────────────────────────
PADDLE_API_KEY=...
NEXT_PUBLIC_PADDLE_ENV=sandbox

Security Notes

  • Variables prefixed with NEXT_PUBLIC_ are embedded in the client-side bundle. Only use this prefix for non-secret values.
  • SUPABASE_SERVICE_ROLE_KEY, OPENAI_API_KEY, and CRYPTR_SECRET_KEY must never be exposed to the browser.
  • Rotate keys immediately if they are accidentally committed or leaked.
PreviousEmail Inbound
NextRate Limits