Services 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)
service.create POST
Service Created
Sent when a new service is created in Alladdin.
Payload
object
Service data included in webhook payloads
id string
Service unique identifier
name string
Service name
code string
Service code
description string
Service description
price string
Sale price
cost string
Cost price
salesAccount string | null
Sales account code
color string | null
Color in hexadecimal format
duration number<float> | null
Duration in minutes
archived boolean
Whether the service is archived
tags[] string[]
Tag identifiers
taxes[] string[]
Tax keys
Example payload
{
"id": "string",
"name": "string",
"code": "string",
"description": "string",
"price": "string",
"cost": "string",
"salesAccount": "string",
"color": "string",
"duration": 0,
"archived": false,
"tags": [
"string"
],
"taxes": [
"string"
]
}service.update POST
Service Updated
Sent when an existing service is updated in Alladdin.
Payload
object
Service data included in webhook payloads
id string
Service unique identifier
name string
Service name
code string
Service code
description string
Service description
price string
Sale price
cost string
Cost price
salesAccount string | null
Sales account code
color string | null
Color in hexadecimal format
duration number<float> | null
Duration in minutes
archived boolean
Whether the service is archived
tags[] string[]
Tag identifiers
taxes[] string[]
Tax keys
Example payload
{
"id": "string",
"name": "string",
"code": "string",
"description": "string",
"price": "string",
"cost": "string",
"salesAccount": "string",
"color": "string",
"duration": 0,
"archived": false,
"tags": [
"string"
],
"taxes": [
"string"
]
}service.delete POST
Service Deleted
Sent when a service is deleted in Alladdin.
Payload
object
Service data included in delete webhook payloads
id string
Service unique identifier
deletedAt string
Deletion timestamp in ISO 8601 format
Example payload
{
"id": "string",
"deletedAt": "string"
}