Skip to main content

Sales Orders 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)

salesorder.createPOST

Sales Order Created

Sent when a new sales order is created in Holded.

Payload

object

Document data included in webhook payloads

idstring

Document unique identifier

typestring

Document type (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Document number

datestring | null

Document date in ISO 8601 format

dueDatestring | null

Due date in ISO 8601 format

contactIdstring | null

Contact unique identifier

contactNamestring | null

Contact name

totalstring | null

Total amount

subtotalstring | null

Subtotal amount

isDraftboolean | null

Whether the document is a draft

statusstring | null

Document status

languagestring | null

Document language code

descriptionstring | null

Document description

notesstring | null

Document notes

numberLineIdstring | null

Number series identifier

currencystring | null

Currency code

currencyChangenumber<float> | null

Currency exchange rate

discountstring | null

Discount amount

taxstring | null

Tax amount

paymentMethodstring | null

Payment method identifier

paymentsTotalstring | null

Total amount already paid

paymentsPendingstring | null

Amount pending payment

warehouseIdstring | null

Warehouse identifier

marketplacestring | null

Marketplace name

trackingKeystring | null

Tracking key

trackingNamestring | null

Tracking carrier name

trackingNumberstring | null

Tracking number

accountingDatestring | null

Accounting date in ISO 8601 format

approvedAtstring | null

Approved at date in ISO 8601 format

tags[]string[] | null

Tags assigned to the document

customFields[]object[] | null

Custom fields

lines[]object[] | null

Document line items

payments[]object[] | null

Payment records

comments[]object[] | null

Comments on the document

Example payload

json
{
  "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.updatePOST

Sales Order Updated

Sent when an existing sales order is updated in Holded.

Payload

object

Document data included in webhook payloads

idstring

Document unique identifier

typestring

Document type (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Document number

datestring | null

Document date in ISO 8601 format

dueDatestring | null

Due date in ISO 8601 format

contactIdstring | null

Contact unique identifier

contactNamestring | null

Contact name

totalstring | null

Total amount

subtotalstring | null

Subtotal amount

isDraftboolean | null

Whether the document is a draft

statusstring | null

Document status

languagestring | null

Document language code

descriptionstring | null

Document description

notesstring | null

Document notes

numberLineIdstring | null

Number series identifier

currencystring | null

Currency code

currencyChangenumber<float> | null

Currency exchange rate

discountstring | null

Discount amount

taxstring | null

Tax amount

paymentMethodstring | null

Payment method identifier

paymentsTotalstring | null

Total amount already paid

paymentsPendingstring | null

Amount pending payment

warehouseIdstring | null

Warehouse identifier

marketplacestring | null

Marketplace name

trackingKeystring | null

Tracking key

trackingNamestring | null

Tracking carrier name

trackingNumberstring | null

Tracking number

accountingDatestring | null

Accounting date in ISO 8601 format

approvedAtstring | null

Approved at date in ISO 8601 format

tags[]string[] | null

Tags assigned to the document

customFields[]object[] | null

Custom fields

lines[]object[] | null

Document line items

payments[]object[] | null

Payment records

comments[]object[] | null

Comments on the document

Example payload

json
{
  "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.deletePOST

Sales Order Deleted

Sent when a sales order is deleted in Holded.

Payload

object

Deleted document data included in webhook payloads

idstring

Document unique identifier

typestring

Document type (invoice, salesorder, estimate, etc.)

documentNumberstring | null

Document number

contactIdstring | null

Contact unique identifier

Example payload

json
{
  "id": "string",
  "type": "string",
  "documentNumber": "string",
  "contactId": "string"
}