Skip to main content

​
Overview

Account events notify you of every change to accounts in BookingShake: account.created, account.updated, and account.deleted. An account represents a company attached to your venue. Common use cases:
  • Sync companies to external CRM systems (Salesforce, HubSpot, etc.)
  • Keep billing information up to date in your invoicing tools
  • Maintain data consistency across multiple platforms

​
Payload Examples

​
Account Created

Triggered when a new account (company) is added to your venue. 
{
  "event": "account.created",
  "timestamp": 1731495000000,
  "venue_id": "venue123",
  "venues_group_id": "group456",
  "data": {
    "id": "account-123",
    "name": "Acme Corp",
    "legal_name": "ACME CORPORATION SAS",
    "company_type": "SAS",
    "company_registration_id": "123456789",
    "vat_number": "FR12345678901",
    "address_line_1": "123 rue Example",
    "address_line_2": "Batiment A",
    "postal_code": "75001",
    "city": "Paris",
    "country": "France",
    "billing_address_line_1": "123 rue Example",
    "billing_postal_code": "75001",
    "billing_city": "Paris",
    "billing_country": "France",
    "accounting_account": "411000",
    "created_at": 1731495000000
  }
}

​
Account Updated

Triggered when account information is modified. Contains all account data after the update. 
{
  "event": "account.updated",
  "timestamp": 1731495100000,
  "venue_id": "venue123",
  "venues_group_id": "group456",
  "data": {
    "id": "account-123",
    "name": "Acme Corporation",
    "legal_name": "ACME CORPORATION SAS",
    "company_type": "SAS",
    "company_registration_id": "123456789",
    "vat_number": "FR98765432101",
    "address_line_1": "123 rue Example",
    "address_line_2": "Batiment A",
    "postal_code": "75001",
    "city": "Paris",
    "country": "France",
    "billing_address_line_1": "123 rue Example",
    "billing_postal_code": "75001",
    "billing_city": "Paris",
    "billing_country": "France",
    "accounting_account": "411000",
    "created_at": 1731495000000
  }
}
account.updated is only emitted when at least one field exposed in the payload (including custom fields) actually changes. Internal or technical changes do not emit events.

​
Account Deleted

Triggered when an account is removed. Only includes the account ID. 
{
  "event": "account.deleted",
  "timestamp": 1731495200000,
  "venue_id": "venue123",
  "venues_group_id": "group456",
  "data": {
    "id": "account-123"
  }
}

​
Data Fields

FieldTypeDescription
idstringUnique account ID
namestringCompany display name
legal_namestringRegistered legal name
company_typestringLegal form (e.g., SAS, SARL)
company_registration_idstringCompany registration number (SIREN in France)
siretstringSIRET number (France)
vat_numberstringVAT number
rcs_numberstringTrade register number (RCS)
sectorstringBusiness sector
address_line_1stringMain address
address_line_2stringMain address, line 2
postal_codestringMain address postal code
citystringMain address city
countrystringMain address country, verbatim as entered
billing_address_line_1stringBilling address
billing_address_line_2stringBilling address, line 2
billing_postal_codestringBilling address postal code
billing_citystringBilling address city
billing_countrystringBilling address country, verbatim as entered
accounting_accountstringAccounting account code
created_atnumberCreation timestamp, Unix milliseconds
custom_<uuid>anyCustom fields configured for your venue
Fields without a value are omitted from account and contact payloads (no explicit null), so the exact set of keys varies per account. This differs from invoice and payment payloads, where every field is always present with an explicit null.

​
Next Steps

Contact Events

Track the people attached to your accounts

Security & Verification

Verify webhook signatures before processing