Skip to main content

Warehouses Webhooks

3 events

Common headers

Every webhook request includes these headers:

x-holded-webhook-eventstring

Event name, e.g. invoice.create

x-holded-webhook-datestring · ISO 8601

When the event was sent, e.g. 2026-06-18T11:10:35Z

x-holded-webhook-signaturestring

HMAC-SHA256 signature with the sha256= prefix (see below)

x-holded-webhook-idstring

Unique event identifier; use it as an idempotency key

x-holded-webhook-account-idstring

Identifier of the Holded account that triggered the event

x-holded-webhook-versionstring

Webhook system version (e.g. v1)

warehouse.createPOST

Warehouse Created

Sent when a new warehouse is created in Holded.

Payload

object

Warehouse data included in webhook payloads

idstring

Warehouse unique identifier

namestring

Warehouse name

notesstring | null

Warehouse notes

emailstring | null

Warehouse email address

phonestring | null

Warehouse phone number

mobilestring | null

Warehouse mobile number

addressobject | null

Warehouse address

addressstring | null
localitystring | null
regionstring | null
postalCodestring | null
countrystring | null
countryCodestring | null
colorstring

Warehouse color in hexadecimal

iconstring

Warehouse icon

defaultboolean | null

Whether this is the default warehouse

Example payload

json
{
  "id": "string",
  "name": "string",
  "notes": "string",
  "email": "string",
  "phone": "string",
  "mobile": "string",
  "address": {
    "address": "string",
    "locality": "string",
    "region": "string",
    "postalCode": "string",
    "country": "string",
    "countryCode": "string"
  },
  "color": "string",
  "icon": "string",
  "default": false
}
warehouse.updatePOST

Warehouse Updated

Sent when an existing warehouse is updated in Holded.

Payload

object

Warehouse data included in webhook payloads

idstring

Warehouse unique identifier

namestring

Warehouse name

notesstring | null

Warehouse notes

emailstring | null

Warehouse email address

phonestring | null

Warehouse phone number

mobilestring | null

Warehouse mobile number

addressobject | null

Warehouse address

addressstring | null
localitystring | null
regionstring | null
postalCodestring | null
countrystring | null
countryCodestring | null
colorstring

Warehouse color in hexadecimal

iconstring

Warehouse icon

defaultboolean | null

Whether this is the default warehouse

Example payload

json
{
  "id": "string",
  "name": "string",
  "notes": "string",
  "email": "string",
  "phone": "string",
  "mobile": "string",
  "address": {
    "address": "string",
    "locality": "string",
    "region": "string",
    "postalCode": "string",
    "country": "string",
    "countryCode": "string"
  },
  "color": "string",
  "icon": "string",
  "default": false
}
warehouse.deletePOST

Warehouse Deleted

Sent when a warehouse is deleted in Holded.

Payload

object

Warehouse data included in delete webhook payloads

idstring

Warehouse unique identifier

deletedAtstring

Deletion timestamp in ISO 8601 format

Example payload

json
{
  "id": "string",
  "deletedAt": "string"
}