API / Integrations

Let external systems connect to your Vava inventory

Active section View API Docs

Priority

Connect Your System — Push In

Your ERP, scale or POS sends stock to Vava by calling the endpoints below with an API key. This is the primary way inventory arrives — no access to your systems is required.

Your Inventory API

Base URL & account your systems authenticate against

Live

Base URL

Account ID

Ingest Endpoints

Method	Endpoint	Receives
POST	/v1/stock/slabs	Finished slabs
POST	/v1/stock/blocks	Raw blocks
POST	/v1/stock/bundles	Bundles / lots
POST	/v1/stock/tiles	Tiles & pavers (quantity)
POST	/v1/catalog/products	Catalog products
POST	/v1/pricing	Price lists

Authenticate with a key secret: Authorization: Bearer <secret> · Sandbox base URL https://sandbox.api.vava.cloud/v1

Key Name	Key ID	Secret	Scopes	Environment	Last Used	Status
StoneERP ProductionCreated Jun 12, 2026	pk_live_a1b2c3	sk_live_••••••4f9a	stock:write	Live	12 min ago	Active
Verona Block ScaleCreated May 30, 2026	pk_live_d4e5f6	sk_live_••••••7c1d	stock:write	Live	2 h ago	Active
Dallas Tile POSCreated Apr 18, 2026	pk_live_g7h8i9	sk_live_••••••b2e0	stock:writepricing:write	Live	3 d ago	Expiring
Sandbox TestCreated Jul 1, 2026	pk_test_j1k2l3	sk_test_••••••9a3f	stock:write	Sandbox	Never used	Active

A key's secret is shown once at creation — after that it stays masked. Rotate or revoke anytime.

Webhooks & Signing

Vava signs every event it sends so your system can verify it's genuine

Signing Secret

Callback URL

Events sent: stock.published stock.updated sync.failed key.rotated

Optional

Outbound Connections — Pull From a System

Only if a system grants Vava access to fetch from it instead of pushing. Connect it here, then run a pull from Receive Stock.

System	Type	Endpoint	Feeds	Last Sync	Status
StoneERP NightlyOAuth	REST API	https://api.stoneerp.local	Blocks, Slabs	12 min ago	Connected
Verona Block ScaleKey file	SFTP	sftp://verona-scale	Blocks (weight / volume)	2 h ago	Connected
Dallas Tile POSOAuth	REST API	https://api.tilepos.local	Tiles, Pavers, Pricing	3 d ago	Auth expiring

Last edited by Supplier Admin · Jul 2, 2026 API Docs

Settings

Configuration