Xenoara Pro

Secure checkout

Order before 2 pm and most items leave our warehouse the same day. Thousands of five-star reviews from customers who came back for more.

12 min read Updated Mar 22, 2026 v4.2.7

Overview

Pay securely with card, wallet or in three interest-free instalments. Our packaging is plastic-free and every delivery is carbon-neutral. We listen first, then build a plan around what you actually need. Thousands of shoppers already trust us, and we work hard to keep it that way.

Sustainable materialsEvery piece is made in small batches from materials we test ourselves.Hand-checked qualityFriendly people answer your questions quickly, by phone, chat or email.Carbon-neutral deliveryEvery detail is handled by people who care about getting it right.

Installation

Install the SDK with the package manager your project already uses. It needs Node 18 or newer.

terminal
$ npm install @xenoara-pro/sdk
terminal
$ yarn add @xenoara-pro/sdk
terminal
$ pnpm add @xenoara-pro/sdk
Using a server without Node? The same endpoints are available over plain HTTPS; see the API reference below.

Configuration

Clear prices, honest advice and no surprises along the way. Start in minutes and get help from a real person whenever you need it. Create a file named xenoara-pro.config.json in the project root:

xenoara-pro.config.json
{
  "project": "xenoara-pro",
  "region": "eu-west",
  "categories": ["apparel", "home", "accessories"],
  "retries": 2,
  "timeoutMs": 10000,
  "webhooks": { "enabled": true }
}
OptionTypeDefaultDescription
projectstring-Your project key from the dashboard.
regionstring"us-east"Data centre closest to your shoppers.
retriesnumber3How often a failed call is retried.
timeoutMsnumber10000Time before a request is cancelled.
webhooks.enabledbooleanfalseSend events to your endpoint.

Your first request

We keep things simple, so you can focus on what matters to you.

  1. Create an API keyOpen the dashboard, choose Settings › API keys and copy a new secret key.
  2. Store it safelyKeep the key in an environment variable, never in your source code.
  3. Make the callRun the snippet below; it prints the first page of results.
index.js
import { Client } from "@xenoara-pro/sdk";

const client = new Client({ apiKey: process.env.API_KEY });

// list the newest products in one category
const page = await client.products.list({ category: "apparel", limit: 20 });

for (const item of page.data) {
  console.log(item.name, item.price);
}
Heads up: test keys only return sample data. Switch to a live key before you go to production.

API reference

Every endpoint returns JSON and uses standard HTTP status codes.

GET/v1/productsList products with paging and filters.
POST/v1/productsCreate a new product.
PATCH/v1/products/{id}Update some fields of a product.
DELETE/v1/products/{id}Archive a product; it can be restored for 30 days.
response.json
{
  "data": [
    { "id": "product_5375", "name": "Desk lamp", "price": 203 }
  ],
  "has_more": true
}

Troubleshooting

Gift wrapping and a handwritten note are free on every order. Not sure about the size? Our fit guide and live chat help you choose.

We measure success by how many shoppers come back and tell their friends. Free shipping on orders over $50 and easy returns within 30 days.

We work directly with makers, so prices stay fair for everyone. Our team has done this many times, so you never have to guess.

Next steps

New pieces arrive every month, and the best ones sell out fast.

Was this page helpful?
All screens