Contactos Webhooks

3 eventos

Cabeceras comunes

Cada petición de webhook incluye estas cabeceras:

x-holded-webhook-eventstring

Nombre del evento, p. ej. invoice.create

x-holded-webhook-datestring · ISO 8601

Momento del envío, p. ej. 2026-06-18T11:10:35Z

x-holded-webhook-signaturestring

Firma HMAC-SHA256 con prefijo sha256= (ver abajo)

x-holded-webhook-idstring

Identificador único del evento; úsalo como clave de idempotencia

x-holded-webhook-account-idstring

Identificador de la cuenta de Holded que origina el evento

x-holded-webhook-versionstring

Versión del sistema de webhooks (p. ej. v1)

contact.createPOST

Contacto creado

Se envía cuando se crea un contacto en Holded.

Payload

object

Datos del contacto incluidos en los payloads de webhook

idstring

Identificador único del contacto

namestring

Nombre del contacto

isPersonboolean

Indica si el contacto es una persona (true) o una empresa (false). Nulo cuando no está disponible en el evento.

typestring | null

Tipo de contacto: cliente, deudor, proveedor, acreedor, lead

tradeNamestring | null

Nombre comercial

taxIdNumberstring | null

Número de identificación fiscal (NIF/CIF)

vatNumberstring | null

Número de IVA

emailstring | null

Dirección de correo electrónico principal

phoneNumberstring | null

Número de teléfono

mobileNumberstring | null

Número de teléfono móvil

websitestring | null

URL del sitio web

address[]array | null

Dirección de facturación

tags[]array | null

Etiquetas

usersAssigned[]array | null

IDs de usuarios asignados

banks[]array | null

Cuentas bancarias (IBAN, SWIFT, mandato SEPA)

ibanstring | null

IBAN (campo legado de cuenta única)

swiftstring | null

Código SWIFT/BIC (campo legado de cuenta única)

sepaRefstring | null

Referencia del mandato SEPA

sepaDatestring | null

Fecha del mandato SEPA en formato ISO 8601

defaults[]array | null

Configuración predeterminada (idioma, condiciones de pago, impuestos…)

ratestring | null

Tarifa / lista de precios

auxIdstring | null

Referencia interna / auxId

paymentMethodstring | null

Método de pago

printOptions[]array | null

Opciones de impresión (mostrar nombre comercial, mostrar país…)

clientAccountingAccountstring | null

ID de cuenta contable de cliente / deudor

supplierAccountingAccountstring | null

ID de cuenta contable de proveedor / acreedor

taxOperationstring | null

Tipo de operación fiscal

createdAtstring | null

Fecha de creación en formato ISO 8601

updatedAtstring | null

Fecha de última actualización en formato ISO 8601

Payload de ejemplo

json

{
  "id": "string",
  "name": "string",
  "isPerson": false,
  "type": "string",
  "tradeName": "string",
  "taxIdNumber": "string",
  "vatNumber": "string",
  "email": "string",
  "phoneNumber": "string",
  "mobileNumber": "string",
  "website": "string",
  "address": [],
  "tags": [],
  "usersAssigned": [],
  "banks": [],
  "iban": "string",
  "swift": "string",
  "sepaRef": "string",
  "sepaDate": "string",
  "defaults": [],
  "rate": "string",
  "auxId": "string",
  "paymentMethod": "string",
  "printOptions": [],
  "clientAccountingAccount": "string",
  "supplierAccountingAccount": "string",
  "taxOperation": "string",
  "createdAt": "string",
  "updatedAt": "string"
}

contact.updatePOST

Contacto actualizado

Se envía cuando se actualiza un contacto existente en Holded.

Payload

object

Datos del contacto incluidos en los payloads de webhook

idstring

Identificador único del contacto

namestring

Nombre del contacto

isPersonboolean

Indica si el contacto es una persona (true) o una empresa (false). Nulo cuando no está disponible en el evento.

typestring | null

Tipo de contacto: cliente, deudor, proveedor, acreedor, lead

tradeNamestring | null

Nombre comercial

taxIdNumberstring | null

Número de identificación fiscal (NIF/CIF)

vatNumberstring | null

Número de IVA

emailstring | null

Dirección de correo electrónico principal

phoneNumberstring | null

Número de teléfono

mobileNumberstring | null

Número de teléfono móvil

websitestring | null

URL del sitio web

address[]array | null

Dirección de facturación

tags[]array | null

Etiquetas

usersAssigned[]array | null

IDs de usuarios asignados

banks[]array | null

Cuentas bancarias (IBAN, SWIFT, mandato SEPA)

ibanstring | null

IBAN (campo legado de cuenta única)

swiftstring | null

Código SWIFT/BIC (campo legado de cuenta única)

sepaRefstring | null

Referencia del mandato SEPA

sepaDatestring | null

Fecha del mandato SEPA en formato ISO 8601

defaults[]array | null

Configuración predeterminada (idioma, condiciones de pago, impuestos…)

ratestring | null

Tarifa / lista de precios

auxIdstring | null

Referencia interna / auxId

paymentMethodstring | null

Método de pago

printOptions[]array | null

Opciones de impresión (mostrar nombre comercial, mostrar país…)

clientAccountingAccountstring | null

ID de cuenta contable de cliente / deudor

supplierAccountingAccountstring | null

ID de cuenta contable de proveedor / acreedor

taxOperationstring | null

Tipo de operación fiscal

createdAtstring | null

Fecha de creación en formato ISO 8601

updatedAtstring | null

Fecha de última actualización en formato ISO 8601

Payload de ejemplo

json

{
  "id": "string",
  "name": "string",
  "isPerson": false,
  "type": "string",
  "tradeName": "string",
  "taxIdNumber": "string",
  "vatNumber": "string",
  "email": "string",
  "phoneNumber": "string",
  "mobileNumber": "string",
  "website": "string",
  "address": [],
  "tags": [],
  "usersAssigned": [],
  "banks": [],
  "iban": "string",
  "swift": "string",
  "sepaRef": "string",
  "sepaDate": "string",
  "defaults": [],
  "rate": "string",
  "auxId": "string",
  "paymentMethod": "string",
  "printOptions": [],
  "clientAccountingAccount": "string",
  "supplierAccountingAccount": "string",
  "taxOperation": "string",
  "createdAt": "string",
  "updatedAt": "string"
}

contact.deletePOST

Contacto eliminado

Se envía cuando se elimina un contacto en Holded.

Payload

object

Datos del contacto incluidos en los payloads de webhook de eliminación

idstring

Identificador único del contacto

isPersonboolean

Indica si el contacto era una persona (true) o una empresa (false)

deletedAtstring

Fecha de eliminación en formato ISO 8601

Payload de ejemplo

json

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