Custom integration

Connect WatchTraderHub to your own systems

Run inventory and orders through your own platform via a REST API and HMAC-signed outbound webhooks. Built for dealers who already have a tech stack and need WatchTraderHub as the source of truth.

Start with FreeRead the docs
No credit card required3-minute setupCancel anytimeGDPR compliant

Authenticated request

GET /api/v1/listingsbash
curl -X GET https://www.watchtraderhub.com/api/v1/listings \
  -H "Authorization: Bearer wth_YOUR_API_KEY" \
  -H "Accept: application/json"
12
API operations
10
Webhook events
HMAC-SHA256
Delivery signatures
Test mode
Included

REST API

Listings, orders, and customers over HTTP

Read your listings, write orders and customers, and cancel what needs cancelling, all through a versioned HTTP API authenticated with a bearer key. The surface is small on purpose: enough to run a storefront or an ERP against WatchTraderHub without guessing at undocumented corners.

  • Cursor-based pagination on list endpoints
  • Idempotent writes with a 24-hour TTL
  • Token-bucket rate limits, 429 responses carry a Retry-After header
  • OpenAPI 3.1 spec at /api/v1/openapi.json, Postman collection at /openapi/v1.postman.json
Read the full API reference

Operations

  • GET /v1/listings
  • GET /v1/listings/:id
  • POST /v1/customers
  • POST /v1/customers/bulk
  • GET /v1/orders
  • POST /v1/orders
  • POST /v1/orders/:id/cancel
  • GET /v1/me

Webhooks

Events pushed to you, signed on every delivery

When a listing publishes, sells, or changes, WatchTraderHub POSTs the event to your endpoint. Every delivery carries a WTH-Signature header in the form t=timestamp,v1=hmac_hex; you verify it by computing HMAC-SHA256 over the timestamp and raw body, with a 5-minute replay window.

  • 10 event types: listing.*, order.*, customer.matched, integration.test_event
  • Wildcard or per-namespace subscriptions
  • Signing-secret rotation with a dual-secret grace period, no dropped deliveries
  • Delivery log records every attempt, with manual retry from the dashboard
Webhook signing and retry details
POST to your webhook endpointhttp
POST https://your-server.example.com/webhooks/wth HTTP/1.1
Content-Type: application/json
WTH-Signature: t=1716120000,v1=3b4c5d...

{
  "event": "listing.published",
  "data": {
    "id": "inv_abc123",
    "brand": "Rolex",
    "model": "Submariner",
    "asking_price_eur": 14500
  }
}

Test mode

Prove the integration before it touches live data

Test mode is active from the moment you enable the channel. Requests run against an isolated test key, webhook deliveries stay clear of production data, and nothing you do while testing shows up in your dashboards or reports.

  • Separate test API key, same dashboard
  • POST /api/v1/test/webhook_ping fires a real delivery to your receiver
  • Test rows are flagged in API responses and kept out of your dashboards
  • On by default until you flip to live mode
Test key issuedIsolated from live data
webhook_ping firedintegration.test_event delivered
Signature verifiedHMAC check passed on your receiver
Live mode onReal inventory events start flowing

How it works

From zero to a verified live integration in four steps.

  1. 01

    Generate an API key

    Open Channels, then Custom Integration, in your dealer dashboard. Keys have the shape wth_ plus 32 base62 characters; only the first 12 characters and a SHA-256 hash are stored, and the full key is shown once.

  2. 02

    Configure your webhook

    Enter the HTTPS URL WatchTraderHub should POST events to, generate a signing secret, and pick the event types to receive, or subscribe to all of them with a wildcard.

  3. 03

    Verify in test mode

    Call POST /api/v1/test/webhook_ping to fire an integration.test_event at your receiver, then check the delivery log and confirm your HMAC signature validation passes.

  4. 04

    Flip to live mode

    Disable test mode and real inventory events start flowing to your endpoint. The delivery log stays available for ongoing monitoring.

Included from Business, EUR 199/month billed annually (EUR 249 monthly).

Business also includes 250 inventory items, 3 team seats, and 500 AI descriptions per month.

  • Free
  • Starter
  • Pro
  • Business
Compare plans

Common questions

Related features

Marketplace syncDealer analyticsInvoicingInventory managementAll dealer tools

Wire up your own systems

A REST API, signed webhooks, a delivery log, and a test mode that lets you verify everything before a single live event fires.

Get started with BusinessRead the API documentation
No credit card required3-minute setupCancel anytimeGDPR compliant