Contactes Webhooks

3 esdeveniments

Capçaleres comunes

Cada petició de webhook inclou aquestes capçaleres:

x-holded-webhook-eventstring

Nom de l'esdeveniment, p. ex. invoice.create

x-holded-webhook-datestring · ISO 8601

Moment de l'enviament, p. ex. 2026-06-18T11:10:35Z

x-holded-webhook-signaturestring

Signatura HMAC-SHA256 amb prefix sha256= (vegeu a sota)

x-holded-webhook-idstring

Identificador únic de l'esdeveniment; utilitza'l com a clau d'idempotència

x-holded-webhook-account-idstring

Identificador del compte de Holded que origina l'esdeveniment

x-holded-webhook-versionstring

Versió del sistema de webhooks (p. ex. v1)

contact.createPOST

Contacte creat

S'envia quan es crea un contacte a Holded.

Payload

object

Dades del contacte incloses en els payloads de webhook

idstring

Identificador únic del contacte

namestring

Nom del contacte

isPersonboolean

Indica si el contacte és una persona (true) o una empresa (false). Nul quan no està disponible en l'esdeveniment.

typestring | null

Tipus de contacte: client, deutor, proveïdor, creditor, lead

tradeNamestring | null

Nom comercial

taxIdNumberstring | null

Número d'identificació fiscal (NIF/CIF)

vatNumberstring | null

Número de VAT

emailstring | null

Adreça de correu electrònic principal

phoneNumberstring | null

Número de telèfon

mobileNumberstring | null

Número de telèfon mòbil

websitestring | null

URL del lloc web

addressobject | null

Adreça de facturació

streetstring | null

citystring | null

postcodestring | null

provincestring | null

countryCodestring | null

countryNamestring | null

extraInfostring | null

tags[]string[] | null

Etiquetes

usersAssigned[]string[] | null

IDs d'usuaris assignats

banks[]object[] | null

Comptes bancaris (IBAN, SWIFT, mandat SEPA)

ibanstring | null

IBAN (camp llegat d'un sol compte)

swiftstring | null

Codi SWIFT/BIC (camp llegat d'un sol compte)

sepaRefstring | null

Referència del mandat SEPA

sepaDatestring | null

Data del mandat SEPA en format ISO 8601

defaultsobject | null

Configuració predeterminada (idioma, condicions de pagament, impostos…)

languagestring | null

currencystring | null

salesAccountIdstring | null

purchasesAccountIdstring | null

paymentMethodstring | null

dueDaysinteger | null

discountinteger | null

paymentDayinteger | null

salesTax[]string[] | null

purchasesTax[]string[] | null

customFields[]object[] | null

Camps personalitzats

ratestring | null

Tarifa / llista de preus

auxIdstring | null

Referència interna / auxId

paymentMethodstring | null

Mètode de pagament

printOptions[]object[] | null

Opcions d'impressió (mostra nom comercial, mostra país…)

clientAccountingAccountstring | null

ID de compte comptable de client / deutor

supplierAccountingAccountstring | null

ID de compte comptable de proveïdor / creditor

taxOperationstring | null

Tipus d'operació fiscal

createdAtstring | null

Data de creació en format ISO 8601

updatedAtstring | null

Data de la darrera actualització en format ISO 8601

Payload d'exemple

json

{
  "id": "string",
  "name": "string",
  "isPerson": false,
  "type": "string",
  "tradeName": "string",
  "taxIdNumber": "string",
  "vatNumber": "string",
  "email": "string",
  "phoneNumber": "string",
  "mobileNumber": "string",
  "website": "string",
  "address": {
    "street": "string",
    "city": "string",
    "postcode": "string",
    "province": "string",
    "countryCode": "string",
    "countryName": "string",
    "extraInfo": "string"
  },
  "tags": [
    "string"
  ],
  "usersAssigned": [
    "string"
  ],
  "banks": [
    {}
  ],
  "iban": "string",
  "swift": "string",
  "sepaRef": "string",
  "sepaDate": "string",
  "defaults": {
    "language": "string",
    "currency": "string",
    "salesAccountId": "string",
    "purchasesAccountId": "string",
    "paymentMethod": "string",
    "dueDays": 0,
    "discount": 0,
    "paymentDay": 0,
    "salesTax": [
      "string"
    ],
    "purchasesTax": [
      "string"
    ]
  },
  "customFields": [
    {}
  ],
  "rate": "string",
  "auxId": "string",
  "paymentMethod": "string",
  "printOptions": [
    {}
  ],
  "clientAccountingAccount": "string",
  "supplierAccountingAccount": "string",
  "taxOperation": "string",
  "createdAt": "string",
  "updatedAt": "string"
}

contact.updatePOST

Contacte actualitzat

S'envia quan s'actualitza un contacte existent a Holded.

Payload

object

Dades del contacte incloses en els payloads de webhook

idstring

Identificador únic del contacte

namestring

Nom del contacte

isPersonboolean

Indica si el contacte és una persona (true) o una empresa (false). Nul quan no està disponible en l'esdeveniment.

typestring | null

Tipus de contacte: client, deutor, proveïdor, creditor, lead

tradeNamestring | null

Nom comercial

taxIdNumberstring | null

Número d'identificació fiscal (NIF/CIF)

vatNumberstring | null

Número de VAT

emailstring | null

Adreça de correu electrònic principal

phoneNumberstring | null

Número de telèfon

mobileNumberstring | null

Número de telèfon mòbil

websitestring | null

URL del lloc web

addressobject | null

Adreça de facturació

streetstring | null

citystring | null

postcodestring | null

provincestring | null

countryCodestring | null

countryNamestring | null

extraInfostring | null

tags[]string[] | null

Etiquetes

usersAssigned[]string[] | null

IDs d'usuaris assignats

banks[]object[] | null

Comptes bancaris (IBAN, SWIFT, mandat SEPA)

ibanstring | null

IBAN (camp llegat d'un sol compte)

swiftstring | null

Codi SWIFT/BIC (camp llegat d'un sol compte)

sepaRefstring | null

Referència del mandat SEPA

sepaDatestring | null

Data del mandat SEPA en format ISO 8601

defaultsobject | null

Configuració predeterminada (idioma, condicions de pagament, impostos…)

languagestring | null

currencystring | null

salesAccountIdstring | null

purchasesAccountIdstring | null

paymentMethodstring | null

dueDaysinteger | null

discountinteger | null

paymentDayinteger | null

salesTax[]string[] | null

purchasesTax[]string[] | null

customFields[]object[] | null

Camps personalitzats

ratestring | null

Tarifa / llista de preus

auxIdstring | null

Referència interna / auxId

paymentMethodstring | null

Mètode de pagament

printOptions[]object[] | null

Opcions d'impressió (mostra nom comercial, mostra país…)

clientAccountingAccountstring | null

ID de compte comptable de client / deutor

supplierAccountingAccountstring | null

ID de compte comptable de proveïdor / creditor

taxOperationstring | null

Tipus d'operació fiscal

createdAtstring | null

Data de creació en format ISO 8601

updatedAtstring | null

Data de la darrera actualització en format ISO 8601

Payload d'exemple

json

{
  "id": "string",
  "name": "string",
  "isPerson": false,
  "type": "string",
  "tradeName": "string",
  "taxIdNumber": "string",
  "vatNumber": "string",
  "email": "string",
  "phoneNumber": "string",
  "mobileNumber": "string",
  "website": "string",
  "address": {
    "street": "string",
    "city": "string",
    "postcode": "string",
    "province": "string",
    "countryCode": "string",
    "countryName": "string",
    "extraInfo": "string"
  },
  "tags": [
    "string"
  ],
  "usersAssigned": [
    "string"
  ],
  "banks": [
    {}
  ],
  "iban": "string",
  "swift": "string",
  "sepaRef": "string",
  "sepaDate": "string",
  "defaults": {
    "language": "string",
    "currency": "string",
    "salesAccountId": "string",
    "purchasesAccountId": "string",
    "paymentMethod": "string",
    "dueDays": 0,
    "discount": 0,
    "paymentDay": 0,
    "salesTax": [
      "string"
    ],
    "purchasesTax": [
      "string"
    ]
  },
  "customFields": [
    {}
  ],
  "rate": "string",
  "auxId": "string",
  "paymentMethod": "string",
  "printOptions": [
    {}
  ],
  "clientAccountingAccount": "string",
  "supplierAccountingAccount": "string",
  "taxOperation": "string",
  "createdAt": "string",
  "updatedAt": "string"
}

contact.deletePOST

Contacte eliminat

S'envia quan s'elimina un contacte a Holded.

Payload

object

Dades del contacte incloses en els payloads de webhook d'eliminació

idstring

Identificador únic del contacte

isPersonboolean

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

deletedAtstring

Data d'eliminació en format ISO 8601

Payload d'exemple

json

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