A simple, predictable REST API for building integrations, internal tools and apps on top of Huup. JSON over HTTPS, signed webhooks, and SDKs in your favourite language.
# Create a listing across 3 channels
curl -X POST https://api.huup.com/v1/listings \
-H "Authorization: Bearer $HUUP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sku": "WT 102322",
"title": "FORD TRANSIT MK7 — Side Mould",
"price": 41.58,
"stock": 65,
"channels": ["ebay-uk", "amazon-uk", "shopify"]
}'
# 200 OK · 142ms
{
"id": "lst_8a2f1e9c",
"sku": "WT 102322",
"status": "live",
"channels": {
"ebay-uk": "published",
"amazon-uk": "published",
"shopify": "published"
},
"created_at": "2026-06-02T09:14:22Z"
}Three steps from zero to a live integration. Sandbox keys are free, no credit card.
REST endpoints organised by resource. Each group includes request schemas, response samples and live try-it consoles.
Subscribe to platform events with HMAC-signed POSTs. Retries with exponential backoff, configurable per-event delivery, and a full delivery log in the dashboard.
# Huup webhook payload — order.created
{
"id": "evt_2k4n8q3p",
"type": "order.created",
"created_at": "2026-06-02T09:14:22Z",
"data": {
"order_id": "ord_5fa12c",
"channel": "ebay-uk",
"total": 41.58,
"currency": "GBP",
"items": [
{ "sku": "WT 102322", "qty": 1 }
]
}
}
# Verify the signature
X-Huup-Signature: sha256=a8c3...e1f2Official SDKs for Node and Python. PHP is community-maintained. Go is on the way — drop your email on the changelog page.
Use API keys for server-to-server. Use OAuth when building apps on behalf of other Huup tenants — for example, a public marketplace app.
Generate scoped keys in the dashboard. Send as a bearer token. Rotate any time.
curl https://api.huup.com/v1/orders \
-H "Authorization: Bearer hp_live_8a2f1e9c..."Standard authorization code flow with PKCE. Scopes per resource (read:orders, write:listings, ...).
GET https://auth.huup.com/oauth/authorize?
client_id=...&redirect_uri=...&
response_type=code&scope=read:orders write:listingsWe'd love to feature it. Get in touch with the team or browse partner opportunities.