Sales Orders Webhooks
3 events
Common headers
Every webhook request includes these headers:
x-holded-webhook-eventstringEvent name, e.g. invoice.create
x-holded-webhook-datestring · ISO 8601When the event was sent, e.g. 2026-06-18T11:10:35Z
x-holded-webhook-signaturestringHMAC-SHA256 signature with the sha256= prefix (see below)
x-holded-webhook-idstringUnique event identifier; use it as an idempotency key
x-holded-webhook-account-idstringIdentifier of the Holded account that triggered the event
x-holded-webhook-versionstringWebhook system version (e.g. v1)
salesorder.createPOSTSales Order Created
Sent when a new sales order is created in Holded.
Payload
Document data included in webhook payloads
Document unique identifier
Document type (invoice, salesorder, estimate, etc.)
Document number
Document date in ISO 8601 format
Due date in ISO 8601 format
Contact unique identifier
Contact name
Total amount
Subtotal amount
Whether the document is a draft
Document status
Document language code
Document description
Document notes
Number series identifier
Currency code
Currency exchange rate
Discount amount
Tax amount
Payment method identifier
Total amount already paid
Amount pending payment
Warehouse identifier
Marketplace name
Tracking key
Tracking carrier name
Tracking number
Accounting date in ISO 8601 format
Approved at date in ISO 8601 format
Tags assigned to the document
Custom fields
Document line items
Payment records
Comments on the document
Example payload
{
"id": "string",
"type": "string",
"documentNumber": "string",
"date": "string",
"dueDate": "string",
"contactId": "string",
"contactName": "string",
"total": "string",
"subtotal": "string",
"isDraft": false,
"status": "string",
"language": "string",
"description": "string",
"notes": "string",
"numberLineId": "string",
"currency": "string",
"currencyChange": 0,
"discount": "string",
"tax": "string",
"paymentMethod": "string",
"paymentsTotal": "string",
"paymentsPending": "string",
"warehouseId": "string",
"marketplace": "string",
"trackingKey": "string",
"trackingName": "string",
"trackingNumber": "string",
"accountingDate": "string",
"approvedAt": "string",
"tags": [
"string"
],
"customFields": [
{}
],
"lines": [
{}
],
"payments": [
{}
],
"comments": [
{}
]
}salesorder.updatePOSTSales Order Updated
Sent when an existing sales order is updated in Holded.
Payload
Document data included in webhook payloads
Document unique identifier
Document type (invoice, salesorder, estimate, etc.)
Document number
Document date in ISO 8601 format
Due date in ISO 8601 format
Contact unique identifier
Contact name
Total amount
Subtotal amount
Whether the document is a draft
Document status
Document language code
Document description
Document notes
Number series identifier
Currency code
Currency exchange rate
Discount amount
Tax amount
Payment method identifier
Total amount already paid
Amount pending payment
Warehouse identifier
Marketplace name
Tracking key
Tracking carrier name
Tracking number
Accounting date in ISO 8601 format
Approved at date in ISO 8601 format
Tags assigned to the document
Custom fields
Document line items
Payment records
Comments on the document
Example payload
{
"id": "string",
"type": "string",
"documentNumber": "string",
"date": "string",
"dueDate": "string",
"contactId": "string",
"contactName": "string",
"total": "string",
"subtotal": "string",
"isDraft": false,
"status": "string",
"language": "string",
"description": "string",
"notes": "string",
"numberLineId": "string",
"currency": "string",
"currencyChange": 0,
"discount": "string",
"tax": "string",
"paymentMethod": "string",
"paymentsTotal": "string",
"paymentsPending": "string",
"warehouseId": "string",
"marketplace": "string",
"trackingKey": "string",
"trackingName": "string",
"trackingNumber": "string",
"accountingDate": "string",
"approvedAt": "string",
"tags": [
"string"
],
"customFields": [
{}
],
"lines": [
{}
],
"payments": [
{}
],
"comments": [
{}
]
}salesorder.deletePOSTSales Order Deleted
Sent when a sales order is deleted in Holded.
Payload
Deleted document data included in webhook payloads
Document unique identifier
Document type (invoice, salesorder, estimate, etc.)
Document number
Contact unique identifier
Example payload
{
"id": "string",
"type": "string",
"documentNumber": "string",
"contactId": "string"
}