---
search:
  tags:
    - Change notifications
    - PUT
seo:
  description: >-
    Registers the URL notified when stock changes. Notifications carry no stock
    data:… Reference for the PUT /webhook endpoint in the Toreca Cloud Partner
    API.
sidebar:
  label: Register the webhook
  badge: PUT
title: Register the webhook
type: openapi-operation
---
Registers the URL notified when stock changes. Notifications carry no stock data: read `/inventory/changes` when one arrives. Every call returns a new signing secret. The URL must be https and share an origin with one of the app's redirect URIs.

Notifications are `POST url` with the body `{"type":"inventory.changed","tenantId","connectionId","occurredAt"}`. `X-TorecaCloud-Signature: v1=<hex>` is `HMAC-SHA256("<X-TorecaCloud-Timestamp>.<body>")` keyed with the secret string. Reject a notification whose timestamp is 300 seconds or more off.

`PUT /webhook`