Quick Start
Make your first API call in 5 minutes.
Overview
The Whatalo API lets you programmatically manage products, orders, customers, and more for any Whatalo store. This guide walks you through your first API call.
Explore the Documentation
Whatalo API
REST endpoints for products, orders, customers, webhooks, and store management.
Plugin SDK
Build plugins that extend the admin with full-page iframes, App Bridge, and billing.
Theme SDK
Create custom storefront themes with sections, blocks, and the visual editor.
Step 1: Get Your API Key
- Log in to your Whatalo store dashboard
- Navigate to Settings > Developer > API Keys
- Click Create API Key
- Select the scopes you need (e.g.,
read:products) - Copy the key — it starts with
wk_live_orwk_test_
Your API key is shown only once. Store it securely — you cannot retrieve it later.
Step 2: Make Your First Request
curl -X GET https://api.whatalo.com/v1/products \
-H "X-API-Key: wk_test_your_key_here"const response = await fetch("https://api.whatalo.com/v1/products", {
headers: {
"X-API-Key": "wk_test_your_key_here",
},
});
if (!response.ok) {
throw new Error(`API error: ${response.status}`);
}
const { data } = await response.json();import requests
response = requests.get(
"https://api.whatalo.com/v1/products",
headers={"X-API-Key": "wk_test_your_key_here"},
)
print(response.json())Step 3: Explore the API
Now that you have your key working, explore the full API:
| Resource | Endpoint | Description |
|---|---|---|
| Products | GET /v1/products | List all products |
| Orders | GET /v1/orders | List all orders |
| Customers | GET /v1/customers | List all customers |
| Store | GET /v1/store | Get store info |
| Categories | GET /v1/categories | List categories |
| Discounts | GET /v1/discounts | List discounts |
Environments
| Environment | Key Prefix | Use For |
|---|---|---|
| Test | wk_test_ | Development and testing |
| Live | wk_live_ | Production integrations |
Test keys work against the same data but are rate-limited more aggressively. Use them during development.
Next Steps
- Authentication — Understand scopes and rate limits
- Webhooks — Get notified when events happen
- API Reference — Complete endpoint documentation