Webhooks

Register an HTTPS endpoint in Studio → Developers → Webhooks and receive signed events. Payloads never carry shopper identity or measurements.

Event	When
fit.recommended	A shopper got a size for one of your products
garment.published	A garment version was published (Studio or API)
fit_check.completed	A fit check finished
profile.disconnected	A shopper disconnected your store
usage.threshold_reached	Coming soon: your usage reached a threshold of your plan
webhook.test	You sent a test event from Studio

Every delivery has a TYS-Signature header (t=<unix>,v1=<HMAC-SHA256 hex>). Verify it against the raw body:

const event = tys.webhooks.constructEvent(rawBody, req.headers["tys-signature"], process.env.TYS_WEBHOOK_SECRET!);

Webhooks guideEnvelope, verification in any language, retries, rolling the secret.

constructEvent() (Node.js)

Webhook.construct_event() (Python)