Proforma Invoices 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)
proform.createPOSTProform Created
Sent when a new proforma invoice 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": [
{}
]
}proform.updatePOSTProform Updated
Sent when an existing proforma invoice 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": [
{}
]
}proform.deletePOSTProform Deleted
Sent when a proforma invoice 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"
}