Back to Webhooks →

3 events

Common headers

Every webhook request includes these headers:

x-alladdin-webhook-event string

Event name, e.g. invoice.create

x-alladdin-webhook-date string · ISO 8601

x-alladdin-webhook-signature string

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

x-alladdin-webhook-id string

Unique event identifier; use it as an idempotency key

x-alladdin-webhook-account-id string

Identifier of the Alladdin account that triggered the event

x-alladdin-webhook-version string

Webhook system version (e.g. v1)

warehouse.create POST

Warehouse Created

Sent when a new warehouse is created in Alladdin.

Payload

object

Warehouse data included in webhook payloads

id string

Warehouse unique identifier

name string

Warehouse name

notes string | null

Warehouse notes

email string | null

Warehouse email address

phone string | null

Warehouse phone number

mobile string | null

Warehouse mobile number

address object | null

Warehouse address

address string | null locality string | null region string | null postalCode string | null country string | null countryCode string | null color string

Warehouse color in hexadecimal

icon string

Warehouse icon

default boolean | null

Whether this is the default warehouse

Example payload

{
  "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.update POST

Warehouse Updated

Sent when an existing warehouse is updated in Alladdin.

Payload

object

Warehouse data included in webhook payloads

id string

Warehouse unique identifier

name string

Warehouse name

notes string | null

Warehouse notes

email string | null

Warehouse email address

phone string | null

Warehouse phone number

mobile string | null

Warehouse mobile number

address object | null

Warehouse address

address string | null locality string | null region string | null postalCode string | null country string | null countryCode string | null color string

Warehouse color in hexadecimal

icon string

Warehouse icon

default boolean | null

Whether this is the default warehouse

Example payload

{
  "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.delete POST

Warehouse Deleted

Sent when a warehouse is deleted in Alladdin.

Payload

object

Warehouse data included in delete webhook payloads

id string

Warehouse unique identifier

deletedAt string

Deletion timestamp in ISO 8601 format

Example payload

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