API Connection

Connect this app to the Personalizer by entering the API key from your Personalizer dashboard.

Checking connection...

Personalizer Credentials

The base URL of the Personalizer integrations API. Use localhost when running natively, or host.docker.internal from Docker.

Paste the API key you created in the Personalizer dashboard.

Where to Get an API Key

  1. Open your Personalizer dashboard.
  2. Navigate to Settings -> API Keys.
  3. Click Create API Key, choose an environment (test or live), and copy the generated key.
  4. Paste the key in the form above.

Tip: The key is only shown once when created. If you lose it, you'll need to create a new one.

Storefront Integration

To enable personalization on your storefront, add these environment variables:

PERSONALIZER_API_URL=http://localhost:3001/v1
PERSONALIZER_API_KEY=pos_test_your-key-here

API Endpoints

POST/v1/sessionsCreate session
GET/v1/sessions/:idGet session
POST/v1/sessions/:id/previewGenerate preview
POST/v1/sessions/:id/finalizeFinalize for order

All requests require an Authorization: Bearer <api-key> header.