Overview
The API is a small REST API under https://api-production-c3ca.up.railway.app/api/v1. Each API key belongs to one storage and can only see and change that storage: its products (called items in the API) and suppliers. To work with several storages, create a key in each.
- Read products and suppliers, or only what changed since a point in time.
- Write new products and stock changes (absolute counts or +/− adjustments).
- Webhooks tell your server about product, stock and supplier changes made anywhere: the web, the iPhone and Android apps, CSV import or the API.
API keys and webhooks are part of Inventrackr Pro. Only the storage owner can create them, and they work while the owner’s plan is Pro. Changes made through the API appear in the storage’s activity history as “API key name”, and team members see them live like any other change.
Quick start
- In the Inventrackr web app, open the storage, then Storage settings → Integrations (storage owners only).
- Under API keys, enter a name (for example “Shop till sync”), choose Read only or Read & write, and select Create key.
- Copy the key right away. It starts with
itk_live_and is shown only once: Inventrackr stores just a hash of it. - Call the API with the key in the
Authorizationheader:
curl "https://api-production-c3ca.up.railway.app/api/v1/items?limit=100" \
-H "Authorization: Bearer $INVENTRACKR_API_KEY"The response is a page of items plus a cursor for the next page:
{
"items": [
{
"id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
"name": "Espresso beans",
"description": "House blend, 1 kg bags",
"barcode": "8714789120045",
"quantity": 3.5,
"minimumQuantity": 5,
"unit": "kg",
"priceCents": 1899,
"supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
"supplierName": "Roastery Co.",
"hasImage": false,
"imageVersion": 0,
"version": 7,
"createdAt": "2026-10-02T14:05:11.482Z",
"updatedAt": "2026-11-18T09:31:27.103Z",
"stockStatus": "lowStock"
}
],
"nextCursor": "WyIyMDI2LTExLTE4IDA5OjMxOjI3LjEwMyswMCIsIjNmNmMyYThlLTZiMWQtNGMxZS05YTUyLTJkOGYwYzdiOWUxMCJd"
}Authentication
Send the key as a bearer token on every request:
Authorization: Bearer itk_live_…| Access | Can call |
|---|---|
| Read only (read) | GET /items, GET /items/{id}, GET /suppliers |
| Read & write (write) | Everything above, plus POST /items and PATCH /items/{id}/quantity |
- Keys look like
itk_live_followed by 32 URL-safe characters. The app lists each key by name, its first characters, when it was created and when it was last used. - Revoking a key in the app takes effect immediately; a write still in progress when the key is revoked is refused.
- A missing, malformed or revoked key gets
401 API_KEY_INVALID. If the storage owner’s Pro plan has ended, every key of the storage gets401 PLAN_REQUIREDuntil Pro is active again; the keys themselves are kept. - A read-only key calling a write endpoint gets
403 INSUFFICIENT_SCOPE.
Rate limits
| Limit | Applies to |
|---|---|
| 120 requests per minute | Each API key |
| 600 requests per minute | Each client IP address (IPv6: per /64), counting every /api/v1 request, including ones with invalid keys |
Limits use fixed one-minute windows. Over a limit, the API answers 429 Too Many Requests with a Retry-After header giving the seconds until the window resets. Wait that long before retrying. The 429 body is {"error": "Too many attempts. Please wait a moment and try again."} (it has no code field).
The API can also answer 503 with Retry-After: 1 when a change collided with another change at the same moment; it’s safe to retry. A page of up to 500 items counts as one request, so prefer large pages to many small ones.
Errors
Errors are JSON with a human-readable error message and, for most API-specific errors, a stable machine-readable code. Branch on the status and code, never on the message text.
{
"error": "This API key is invalid or was revoked",
"code": "API_KEY_INVALID"
}| Status | code | When |
|---|---|---|
| 400 | (none) | The body or query failed validation. The response has "error": "Invalid request" and a details array (see below). |
| 400 | INVALID_CURSOR | The cursor parameter isn’t one the API returned. |
| 400 | (none) | An {id} in the path isn’t a UUID ("Invalid identifier"), the JSON is malformed, or text contains invalid Unicode (lone surrogates). |
| 401 | API_KEY_INVALID | No key, a malformed key, or a revoked key. |
| 401 | PLAN_REQUIRED | The storage owner’s plan isn’t Pro (anymore). |
| 403 | INSUFFICIENT_SCOPE | A read-only key called a write endpoint. |
| 404 | NOT_FOUND | The item doesn’t exist in this key’s storage, or the path doesn’t exist. |
| 409 | STOCK_CHANGED | The stock no longer equals the expectedQuantity you sent. |
| 409 | REFERENCE_REMOVED | Something the change refers to (such as the supplier) was deleted at the same moment. Re-read and retry. |
| 413 | (none) | The request body is larger than 256 KB. |
| 429 | (none) | Rate limit exceeded. See Retry-After. |
| 503 | (none) | A conflicting change happened at the same time. Retry after Retry-After seconds. |
| 500 | (none) | Unexpected server error. Retry with backoff; contact support if it persists. |
Validation errors list each problem with its path in the request:
{
"error": "Invalid request",
"details": [
{
"origin": "string",
"code": "too_small",
"minimum": 1,
"inclusive": true,
"path": [
"name"
],
"message": "Too small: expected string to have >=1 characters"
},
{
"code": "custom",
"path": [
"quantity"
],
"message": "Use at most 3 decimal places"
}
]
}Pagination & syncing
GET /items returns items ordered by updatedAt (oldest first, ties broken by id), so you can page through everything or only what changed. Pass limit (1–500, default 100). When there are more items, the response’s nextCursor is a string: send it back as cursor (with the same other parameters) to get the next page. On the last page nextCursor is null. Cursors are opaque; don’t build or modify them.
curl "https://api-production-c3ca.up.railway.app/api/v1/items?limit=500&cursor=WyIyMDI2LTExLTE4IDA5OjMx…" \
-H "Authorization: Bearer $INVENTRACKR_API_KEY"To keep a copy in sync, remember the largest updatedAt you have seen and next time ask for updatedSince that value. updatedSince is inclusive (items updated at or after it), so you’ll see the last item again: upsert by id and use version to skip what you already have. The value must be an ISO 8601 date-time with Z or an offset; URL-encode a + offset as %2B.
curl "https://api-production-c3ca.up.railway.app/api/v1/items?updatedSince=2026-11-18T09:31:27.103Z&limit=500" \
-H "Authorization: Bearer $INVENTRACKR_API_KEY"Objects
Timestamps are ISO 8601 strings in UTC. IDs are lowercase UUIDs.
Item
| Field | Type | Description |
|---|---|---|
| id | string (UUID) | The item’s ID. |
| name | string | Up to 160 characters. |
| description | string | Up to 4,000 characters; empty string when not set. |
| barcode | string | Up to 120 characters; empty string when not set. Not required to be unique. |
| quantity | number | Current stock, ≥ 0, up to 3 decimal places. |
| minimumQuantity | number | The “low stock at” level, ≥ 0, up to 3 decimal places. |
| unit | string | One of each, pack, box, case, roll, ml, l, g, kg, oz, lb, fl_oz, gal, cm, m, in, ft. |
| priceCents | integer | Unit price in the smallest currency unit (cents) of the storage’s currency, which is set in the app. |
| supplierId | string (UUID) | null | The item’s supplier, if any. |
| supplierName | string | null | That supplier’s name. |
| hasImage | boolean | Whether the item has a photo (photos aren’t available through the API). |
| imageVersion | integer | Changes when the photo changes. |
| version | integer | Increases by one with every change to the item. |
| createdAt | string (date-time) | When the item was created. |
| updatedAt | string (date-time) | When the item last changed. |
| stockStatus | string | outOfStock when quantity is 0, lowStock when quantity ≤ minimumQuantity, else inStock. |
{
"id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
"name": "Espresso beans",
"description": "House blend, 1 kg bags",
"barcode": "8714789120045",
"quantity": 3.5,
"minimumQuantity": 5,
"unit": "kg",
"priceCents": 1899,
"supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
"supplierName": "Roastery Co.",
"hasImage": false,
"imageVersion": 0,
"version": 7,
"createdAt": "2026-10-02T14:05:11.482Z",
"updatedAt": "2026-11-18T09:31:27.103Z",
"stockStatus": "lowStock"
}Supplier
| Field | Type | Description |
|---|---|---|
| id | string (UUID) | The supplier’s ID. |
| name | string | The supplier’s name. |
| contactName | string | Empty string when not set. |
| contactEmail | string | Empty string when not set. |
| contactPhone | string | Empty string when not set. |
| createdAt | string (date-time) | When the supplier was added. |
{
"id": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
"name": "Roastery Co.",
"contactName": "Sam Rivera",
"contactEmail": "orders@roastery.example",
"contactPhone": "+1 555 0100",
"createdAt": "2026-09-14T08:12:40.019Z"
}Endpoints
List items
GET/api/v1/itemsRead or write key
| Parameter | Type | Description |
|---|---|---|
| limit | integer, 1–500 | Items per page. Default 100. |
| cursor | string | The nextCursor from the previous page. |
| updatedSince | date-time | Only items whose updatedAt is at or after this moment, e.g. 2026-11-01T00:00:00Z. |
curl "https://api-production-c3ca.up.railway.app/api/v1/items?limit=100" \
-H "Authorization: Bearer $INVENTRACKR_API_KEY"Returns 200 with { "items": [Item, …], "nextCursor": string | null }.
Get an item
GET/api/v1/items/{id}Read or write key
curl "https://api-production-c3ca.up.railway.app/api/v1/items/3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10" \
-H "Authorization: Bearer $INVENTRACKR_API_KEY"Returns 200 with an Item, or 404 NOT_FOUND.
List suppliers
GET/api/v1/suppliersRead or write key
curl "https://api-production-c3ca.up.railway.app/api/v1/suppliers" \
-H "Authorization: Bearer $INVENTRACKR_API_KEY"Returns 200 with an array of all of the storage’s suppliers, sorted by name (not paged).
[
{
"id": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
"name": "Roastery Co.",
"contactName": "Sam Rivera",
"contactEmail": "orders@roastery.example",
"contactPhone": "+1 555 0100",
"createdAt": "2026-09-14T08:12:40.019Z"
}
]Create an item
POST/api/v1/itemsWrite key
| Field | Type | Rules |
|---|---|---|
| name | string, required | 1–160 characters after trimming spaces. |
| description | string | Up to 4,000 characters. Default empty. |
| barcode | string | Up to 120 characters after trimming. Default empty. |
| quantity | number | 0 to 999,999,999,999, at most 3 decimals. Default 0. |
| minimumQuantity | number | Same rules as quantity. Default 0. |
| unit | string | One of the units. Default each. |
| priceCents | integer | 0 to 2,147,483,647. Default 0. |
| supplierId | string (UUID) | null | A supplier of this storage. An ID that isn’t one of the storage’s suppliers is ignored (the item is created without a supplier). |
curl -X POST "https://api-production-c3ca.up.railway.app/api/v1/items" \
-H "Authorization: Bearer $INVENTRACKR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Espresso beans",
"barcode": "8714789120045",
"quantity": 12,
"minimumQuantity": 5,
"unit": "kg",
"priceCents": 1899,
"supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50"
}'Returns 201 Created with the new Item and sends an item.created webhook. Unknown fields are ignored.
Change stock
PATCH/api/v1/items/{id}/quantityWrite key
Send either an absolute quantity or a relative delta (if both are sent, quantity is used):
| Field | Type | Rules |
|---|---|---|
| quantity | number | Sets the stock: 0 to 999,999,999,999, at most 3 decimals. |
| delta | number | Adds to the stock (negative removes): −1,000,000 to 1,000,000, at most 3 decimals. The result never goes below 0. |
| expectedQuantity | number | Optional, with quantity only: the change is refused with 409 STOCK_CHANGED unless the current stock equals this value. Use it to avoid overwriting a count someone else just changed. Ignored with delta. |
| note | string | Optional, up to 280 characters. Shown in the activity history and included in the webhook. |
curl -X PATCH "https://api-production-c3ca.up.railway.app/api/v1/items/3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10/quantity" \
-H "Authorization: Bearer $INVENTRACKR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"delta": -2, "note": "Sold at the counter"}'curl -X PATCH "https://api-production-c3ca.up.railway.app/api/v1/items/3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10/quantity" \
-H "Authorization: Bearer $INVENTRACKR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"quantity": 40, "expectedQuantity": 3.5, "note": "Stock count"}'Returns 200 with the updated Item plus previousQuantity, and sends an item.quantityChanged webhook (and item.lowStock when the change takes the item from above its minimum to at or below it).
{
"id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
"name": "Espresso beans",
"description": "House blend, 1 kg bags",
"barcode": "8714789120045",
"quantity": 1.5,
"minimumQuantity": 5,
"unit": "kg",
"priceCents": 1899,
"supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
"supplierName": "Roastery Co.",
"hasImage": false,
"imageVersion": 0,
"version": 8,
"createdAt": "2026-10-02T14:05:11.482Z",
"updatedAt": "2026-11-18T10:02:44.590Z",
"stockStatus": "lowStock",
"previousQuantity": 3.5
}Webhooks
Webhooks send a signed HTTPS POST to your endpoint when products, stock or suppliers change, whoever made the change and wherever it was made.
Setting up
- In the web app, open the storage, then Storage settings → Integrations → Webhooks (storage owner, Pro).
- Enter your endpoint URL and choose the events to receive.
- Copy the signing secret (
whsec_…). It’s shown only once; to get a new one, delete the webhook and add it again. - Select Send test to check your endpoint, then watch Deliveries for results.
Endpoint URLs must:
- start with
https://(plain HTTP isn’t allowed) and be at most 2,000 characters; - not contain a user name or password;
- point to a public internet host: not an IP address or hostname in a private, loopback, link-local, carrier-grade NAT, multicast or reserved range, and not a single-label name or a name ending in
.localhost,.local,.internal,.localdomain,.home.arpa,.intranet,.lanor.corp.
The host is resolved when you add the webhook and again on every delivery; if any address it resolves to isn’t public, the delivery fails. A storage can have up to 10 webhooks.
Event types
| Event | Sent when | data |
|---|---|---|
| item.created | A product is added (in the apps, by CSV import, or with POST /items). | item: the full Item |
| item.updated | A product’s details are edited in the apps or updated by a CSV import. | item: the full Item after the change |
| item.deleted | A product is deleted. | item: { id, name } |
| item.quantityChanged | Stock changes: adjustments, edits of the count, CSV import, or PATCH …/quantity. | item (after the change), previousQuantity, delta, and note when one was given |
| item.lowStock | A stock change takes a product from above its minimum to at or below it. | item: the full Item |
| supplier.created | A supplier is added (in the apps or by CSV import). | supplier: the full Supplier |
| supplier.updated | A supplier is edited. | supplier: the full Supplier |
| supplier.deleted | A supplier is deleted. | supplier: { id, name } |
An edit that changes the count sends both item.updated and item.quantityChanged; an edit that changes the unit sends only item.updated. Photo changes don’t send events. When a supplier is deleted, its products lose their supplier without separate item.updated events. item.lowStock isn’t sent when a product is created at or below its minimum, or when the minimum is raised above the current stock.
Payload & headers
Every delivery has the same envelope:
| Field | Description |
|---|---|
| id | The event ID (UUID). The same for every endpoint and every retry of this event: use it to drop duplicates. |
| type | The event type, e.g. item.quantityChanged. |
| createdAt | When the event happened (ISO 8601, UTC). |
| storageId | The storage the event belongs to. |
| data | Event-specific data (see the table above). |
{
"id": "6f1c3e0a-2b7d-4f5e-9c1a-8d2e4b6a0f13",
"type": "item.quantityChanged",
"createdAt": "2026-11-18T09:31:27.214Z",
"storageId": "b4a7d2c1-5e6f-4a3b-9c8d-7e6f5a4b3c2d",
"data": {
"item": {
"id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
"name": "Espresso beans",
"description": "House blend, 1 kg bags",
"barcode": "8714789120045",
"quantity": 1.5,
"minimumQuantity": 5,
"unit": "kg",
"priceCents": 1899,
"supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
"supplierName": "Roastery Co.",
"hasImage": false,
"imageVersion": 0,
"version": 8,
"createdAt": "2026-10-02T14:05:11.482Z",
"updatedAt": "2026-11-18T09:31:27.103Z",
"stockStatus": "lowStock"
},
"previousQuantity": 3.5,
"delta": -2,
"note": "Sold at the counter"
}
}{
"id": "6f1c3e0a-2b7d-4f5e-9c1a-8d2e4b6a0f13",
"type": "item.deleted",
"createdAt": "2026-11-18T09:31:27.214Z",
"storageId": "b4a7d2c1-5e6f-4a3b-9c8d-7e6f5a4b3c2d",
"data": {
"item": {
"id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
"name": "Espresso beans"
}
}
}{
"id": "6f1c3e0a-2b7d-4f5e-9c1a-8d2e4b6a0f13",
"type": "supplier.updated",
"createdAt": "2026-11-18T09:31:27.214Z",
"storageId": "b4a7d2c1-5e6f-4a3b-9c8d-7e6f5a4b3c2d",
"data": {
"supplier": {
"id": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
"name": "Roastery Co.",
"contactName": "Sam Rivera",
"contactEmail": "orders@roastery.example",
"contactPhone": "+1 555 0100",
"createdAt": "2026-09-14T08:12:40.019Z"
}
}
}Request headers:
| Header | Value |
|---|---|
| Content-Type | application/json |
| User-Agent | Inventrackr-Webhooks/1.0 |
| Inventrackr-Event | The event type (also in the body), e.g. item.created. |
| Inventrackr-Delivery | The delivery ID (UUID): unique per endpoint and event, unchanged across retries. |
| Inventrackr-Signature | t=<unix seconds>,v1=<hex HMAC-SHA256>; see below. |
Verifying signatures
Check every request before trusting it. The Inventrackr-Signature header looks like this:
Inventrackr-Signature: t=1763458287,v1=0f4c1e5b8a…(64 hex characters)- Split the header on
,and each part on the first=to gett(the time the delivery was sent, in Unix seconds) andv1(the signature). - Build the signed content: the
tvalue, a period, and the raw request body exactly as received:`${t}.${rawBody}`. - Compute an HMAC with SHA-256 over it, using your whole signing secret (including the
whsec_prefix) as the key, and hex-encode it (lowercase). - Compare it with
v1using a constant-time comparison. - Reject the request if
tis more than a few minutes from your clock (5 minutes is a good tolerance), to stop replays. Each attempt, including retries, is signed with a fresht.
import crypto from "node:crypto";
import express from "express";
const secret = process.env.INVENTRACKR_WEBHOOK_SECRET; // "whsec_…", used exactly as shown
const TOLERANCE_SECONDS = 300;
/** Checks an Inventrackr-Signature header ("t=<unix seconds>,v1=<hex>") against the raw body. */
function verifySignature(rawBody, header, secret) {
const parts = Object.fromEntries(
String(header).split(",").map((part) => {
const index = part.indexOf("=");
return [part.slice(0, index).trim(), part.slice(index + 1).trim()];
}),
);
const timestamp = Number(parts.t);
if (!Number.isInteger(timestamp) || !parts.v1) return false;
if (Math.abs(Date.now() / 1000 - timestamp) > TOLERANCE_SECONDS) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(`${timestamp}.`)
.update(rawBody) // the exact bytes received, not re-serialized JSON
.digest("hex");
const a = Buffer.from(expected, "utf8");
const b = Buffer.from(parts.v1, "utf8");
return a.length === b.length && crypto.timingSafeEqual(a, b);
}
const app = express();
// Read the body as raw bytes for this route (before any JSON parser).
app.post("/webhooks/inventrackr", express.raw({ type: "application/json" }), (req, res) => {
if (!verifySignature(req.body, req.get("Inventrackr-Signature") ?? "", secret)) {
return res.status(400).send("Invalid signature");
}
const event = JSON.parse(req.body.toString("utf8"));
res.sendStatus(204); // answer within 10 seconds, then do the work
queueForProcessing(event); // your code: dedupe on event.id
});
app.listen(3000);import hashlib
import hmac
import json
import os
import time
from flask import Flask, abort, request
SECRET = os.environ["INVENTRACKR_WEBHOOK_SECRET"].encode() # "whsec_…", used exactly as shown
TOLERANCE_SECONDS = 300
def verify_signature(raw_body: bytes, header: str) -> bool:
"""Checks an Inventrackr-Signature header ("t=<unix seconds>,v1=<hex>") against the raw body."""
parts = dict(part.strip().split("=", 1) for part in header.split(",") if "=" in part)
try:
timestamp = int(parts["t"])
except (KeyError, ValueError):
return False
if abs(time.time() - timestamp) > TOLERANCE_SECONDS:
return False
signed = f"{timestamp}.".encode() + raw_body # the exact bytes received
expected = hmac.new(SECRET, signed, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, parts.get("v1", ""))
app = Flask(__name__)
@app.post("/webhooks/inventrackr")
def inventrackr_webhook():
raw_body = request.get_data()
if not verify_signature(raw_body, request.headers.get("Inventrackr-Signature", "")):
abort(400)
event = json.loads(raw_body)
queue_for_processing(event) # your code: dedupe on event["id"], process asynchronously
return "", 204Responses & retries
Answer with any 2xx status within 10 seconds to acknowledge a delivery; the response body is ignored. Anything else is a failure: other status codes, redirects (they aren’t followed), timeouts, TLS or connection errors. Do slow work after responding.
Failed deliveries are retried with exponential backoff (±10% jitter), up to 8 attempts in total:
| Attempt | Sent | About … after the first attempt |
|---|---|---|
| 1 | Within seconds of the change | — |
| 2 | 1 minute after attempt 1 | 1 min |
| 3 | 4 minutes after attempt 2 | 5 min |
| 4 | 16 minutes after attempt 3 | 21 min |
| 5 | About 1 hour after attempt 4 | 1 h 25 min |
| 6 | About 4 hours after attempt 5 | 5 h 40 min |
| 7 | 12 hours after attempt 6 | 17 h 40 min |
| 8 (last) | 12 hours after attempt 7 | 29 h 40 min |
- After the 8th failed attempt the delivery is marked failed and isn’t retried. Deliveries still pending after 3 days are also marked failed.
- If deliveries to an endpoint keep failing for more than 3 days with no success in between, the endpoint is disabled (the app shows “Disabled after 3 days of failed deliveries”). Events that happen while it’s disabled aren’t queued for it. A successful Send test turns it back on.
- Webhooks pause while the storage owner isn’t on Pro: no new events are queued and pending retries wait (up to the 3-day limit).
Duplicates & ordering
- At-least-once: a delivery can arrive more than once (for example when your 2xx response was lost). Store the event
idand ignore ones you’ve already processed. - No ordering guarantee: deliveries are sent in parallel and retries can overtake later events. Use the item’s
version(orupdatedAt) to ignore data older than what you already have, or fetch the item withGET /items/{id}for its current state. - The item in an event is its state right after the change, not when the delivery arrives.
Test deliveries & logs
Send test delivers a webhook.test event right away, signed like any other delivery, attempted once and never retried. You can send up to 10 tests per minute per storage. You can’t subscribe to webhook.test.
{
"id": "6f1c3e0a-2b7d-4f5e-9c1a-8d2e4b6a0f13",
"type": "webhook.test",
"createdAt": "2026-11-18T09:31:27.214Z",
"storageId": "b4a7d2c1-5e6f-4a3b-9c8d-7e6f5a4b3c2d",
"data": {
"message": "This is a test delivery from Inventrackr."
}
}Deliveries shows the 50 most recent deliveries for a webhook with their status (pending, succeeded, failed), attempts, your endpoint’s HTTP status or the error, and the next retry time. Delivery logs are kept for 30 days.
CORS & browser use
The API allows cross-origin requests from any origin (Access-Control-Allow-Origin: *) without cookies or credentials. Browsers may send the Authorization and Content-Type headers, can read Retry-After, and cache preflight responses for 10 minutes.
Limits at a glance
| What | Limit |
|---|---|
| API keys per storage | 25 |
| Webhooks per storage | 10 |
| Requests per API key | 120 per minute |
| Requests per IP address | 600 per minute |
| Items per page | 500 (default 100) |
| Request body | 256 KB |
| Webhook response time | 10 seconds |
| Webhook attempts | 8 over about 30 hours |
| Test deliveries | 10 per minute per storage |
| Delivery log | 50 most recent per webhook, kept 30 days |
Versioning & changelog
The version is part of the path: /api/v1. Within v1 you should expect additive changes, such as new fields in responses and webhook payloads, new endpoints and new event types, so ignore fields you don’t know. A change that would break existing integrations would come as a new version. The machine-readable description is at inventrackr.com/openapi.json (OpenAPI 3.1), for client generators and API tools.
Changelog
- : API v1 and webhooks documented publicly: items (list, get, create, change stock), suppliers (list), eight webhook event types, signed deliveries with retries, and the OpenAPI 3.1 spec.
Questions or something missing? Email support@inventrackr.com.