Account Events

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

Field	Type	Description
`id`	string	Unique account ID
`name`	string	Company display name
`legal_name`	string	Registered legal name
`company_type`	string	Legal form (e.g., `SAS`, `SARL`)
`company_registration_id`	string	Company registration number (SIREN in France)
`siret`	string	SIRET number (France)
`vat_number`	string	VAT number
`rcs_number`	string	Trade register number (RCS)
`sector`	string	Business sector
`address_line_1`	string	Main address
`address_line_2`	string	Main address, line 2
`postal_code`	string	Main address postal code
`city`	string	Main address city
`country`	string	Main address country, verbatim as entered
`billing_address_line_1`	string	Billing address
`billing_address_line_2`	string	Billing address, line 2
`billing_postal_code`	string	Billing address postal code
`billing_city`	string	Billing address city
`billing_country`	string	Billing address country, verbatim as entered
`accounting_account`	string	Accounting account code
`created_at`	number	Creation timestamp, Unix milliseconds
`custom_<uuid>`	any	Custom 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.

Getting Started

Webhooks

REST API

Guides

Overview

Payload Examples

Account Created

Account Updated

Account Deleted

Data Fields

Next Steps

Contact Events

Security & Verification

​Overview

​Payload Examples

​Account Created

​Account Updated

​Account Deleted

​Data Fields

​Next Steps

Contact Events

Security & Verification

Overview

Payload Examples

Account Created

Account Updated

Account Deleted

Data Fields

Next Steps