Lavanda Webhook Event Types

This is the list of event types that we currently send.
For guidance on how to listen to these events, take a look at Svix's guide to consuming webhooks.

Event Types

id

string

The unique identifier for the event

type

string

The type of event

user

object

User associated with the auth identity

1 Items

workspace

object

Workspace that the user belongs to

1 Items

Example Auth Identity User Created Event Payload

JSON

{
  "id": "auth_identity_4f7c9c2e-91b3-4a6e-8c5d-2b8e7e6a1c34",
  "type": "v1.auth_identity.user.created",
  "user": {
    "id": "1234567890"
  },
  "workspace": {
    "id": "1234567890"
  }
}

id

string

The unique identifier for the event

type

string

The type of event

user

object

User associated with the auth identity

1 Items

workspace

object

Workspace that the user belongs to

1 Items

Example Auth Identity User Role Bindings Updated Event Payload

JSON

{
  "id": "auth_identity_9c3f2a41-6e5b-4f3a-8d12-7c8a91e4b6df",
  "type": "v1.auth_identity.user.role_bindings.updated",
  "user": {
    "id": "1234567890"
  },
  "workspace": {
    "id": "1234567890"
  }
}

id

string

The unique identifier for the event

type

string

The type of event

user

object

User associated with the auth identity

1 Items

workspace

object

Workspace that the user belongs to

1 Items

Example Auth Identity User Updated Event Payload

JSON

{
  "id": "auth_identity_a22be058-5e0e-4b40-a225-ce35fcfbcffb",
  "type": "v1.auth_identity.user.updated",
  "user": {
    "id": "1234567890"
  },
  "workspace": {
    "id": "1234567890"
  }
}

availability

array[]

Array of availability records

id

string

Unique event identifier

product

object

The product the availability refers to

1 Items

timestamp

string

(date-time)

When the event was emitted

type

string

Type of the event

workspace

object

Workspace context

1 Items

Example Product Availability Updated Event Payload

JSON

{
  "availability": [
    {
      "available": 4,
      "span": {
        "from": "2025-08-11T14:53:39Z",
        "to": "2025-09-29T23:59:59Z"
      },
      "total": 5
    }
  ],
  "id": "availability_fe2044cf-7939-4aec-8132-8874e8a4b3dc",
  "product": {
    "id": "VecTmh6k"
  },
  "timestamp": "2025-08-11T14:53:39Z",
  "type": "v1.availability.product_availability.updated",
  "workspace": {
    "id": "1234567890"
  }
}

availability

array[]

List of availability spans for the unit

id

string

Unique event identifier

timestamp

string

(date-time)

Timestamp of when the event was generated

type

string

Type of the event

unit

object

Unit whose availability was updated

1 Items

workspace

object

Workspace to which the unit belongs

1 Items

Example Unit Availability Updated Event Payload

JSON

{
  "availability": [
    {
      "span": {
        "from": "2025-08-06T00:00:00Z",
        "to": "2025-08-06T23:59:59Z"
      },
      "type": "BLOCKED"
    },
    {
      "span": {
        "from": "2025-08-07T00:00:00Z",
        "to": "2025-08-07T23:59:59Z"
      },
      "type": "AVAILABLE"
    },
    {
      "span": {
        "from": "2025-08-08T14:00:00Z",
        "to": "2026-08-20T10:00:00Z"
      },
      "type": "BOOKED"
    }
  ],
  "id": "availability_62a598b5-72b1-46cb-b8c0-b5d6db4e2b49",
  "timestamp": "2025-08-14T09:44:51Z",
  "type": "v1.availability.unit_availability.updated",
  "unit": {
    "id": "1234567890"
  },
  "workspace": {
    "id": "1234567890"
  }
}

booking

object

Booking information

2 Items

id

string

The unique identifier for the event

type

string

The type of event

workspace

object

Workspace that the booking belongs to

1 Items

Example Booking TTL Updated Event Payload

JSON

{
  "booking": {
    "expiresAt": "2025-10-14T12:00:00Z",
    "id": "1234567890"
  },
  "id": "booking_889d2a18-c760-4b4a-80f3-a7fb9a3f8fbc",
  "type": "v1.booking.booking_ttl.updated",
  "workspace": {
    "id": "1234567890"
  }
}

booking

object

Booking information

1 Items

id

string

The unique identifier for the event

type

string

The type of event

workspace

object

Workspace that the booking belongs to

1 Items

Example Booking Created Event Payload

JSON

{
  "booking": {
    "id": "1234567890"
  },
  "id": "booking_363c6cdf-7920-4752-9606-9ea48bb538b7",
  "type": "v1.booking.created",
  "workspace": {
    "id": "1234567890"
  }
}

booking

object

Information about the booking

3 Items

id

string

The unique identifier for the event

type

string

The type of event

workspace

object

Information about the workspace

1 Items

Example Booking Expired Event Payload

JSON

{
  "booking": {
    "expiredAt": "2025-10-14T12:00:00Z",
    "id": "1234567890",
    "units": [
      {
        "id": "unit_001"
      },
      {
        "id": "unit_002"
      }
    ]
  },
  "id": "booking_889d2a18-c760-4b4a-80f3-a7fb9a3f8fbc",
  "type": "v1.booking.expired",
  "workspace": {
    "id": "1234567890"
  }
}

booking

object

Booking information

1 Items

id

string

The unique identifier for the event

type

string

The type of event

workspace

object

Workspace that the booking belongs to

1 Items

Example Booking Updated Event Payload

JSON

{
  "booking": {
    "id": "1234567890"
  },
  "id": "booking_889d2a18-c760-4b4a-80f3-a7fb9a3f8fbc",
  "type": "v1.booking.updated",
  "workspace": {
    "id": "1234567890"
  }
}

id

string

Unique event identifier

product

object

The product that was created

1 Items

productGroup

object

The product group associated with the product

1 Items

timestamp

string

(date-time)

When the event was emitted

type

string

Type of the event

unitType

object

The unit type associated with the product

1 Items

workspace

object

Workspace context

1 Items

Example Catalog Product Created Event Payload

JSON

{
  "id": "catalog_123e4567-e89b-12d3-a456-426614174000",
  "product": {
    "id": "zzNnKbnw"
  },
  "productGroup": {
    "id": "wd8ML6JP"
  },
  "timestamp": "2025-09-25T14:53:39Z",
  "type": "v1.catalog.product.created",
  "unitType": {
    "id": "1234567890"
  },
  "workspace": {
    "id": "1234567890"
  }
}

id

string

Unique event identifier

product

object

The product that was deleted

1 Items

productGroup

object

The product group associated with the product

1 Items

timestamp

string

(date-time)

When the event was emitted

type

string

Type of the event

unitType

object

The unit type associated with the product

1 Items

workspace

object

Workspace context

1 Items

Example Catalog Product Deleted Event Payload

JSON

{
  "id": "catalog_123e4567-e89b-12d3-a456-426614174000",
  "product": {
    "id": "zzNnKbnw"
  },
  "productGroup": {
    "id": "wd8ML6JP"
  },
  "timestamp": "2025-09-25T14:53:39Z",
  "type": "v1.catalog.product.deleted",
  "unitType": {
    "id": "1234567890"
  },
  "workspace": {
    "id": "1234567890"
  }
}

id

string

Unique event identifier

product

object

The product that was updated

1 Items

productGroup

object

The product group associated with the product

1 Items

timestamp

string

(date-time)

When the event was emitted

type

string

Type of the event

unitType

object

The unit type associated with the product

1 Items

workspace

object

Workspace context

1 Items

Example Catalog Product Updated Event Payload

JSON

{
  "id": "catalog_c2da407d-b9c8-476f-953b-1d2f1f41589b",
  "product": {
    "id": "h9DRRdkr"
  },
  "productGroup": {
    "id": "NNQLLngH"
  },
  "timestamp": "2025-11-03T11:18:15Z",
  "type": "v1.catalog.product.updated",
  "unitType": {
    "id": "123"
  },
  "workspace": {
    "id": "1234567890"
  }
}

id

string

Unique event identifier

productGroup

object

The product group that was created

1 Items

timestamp

string

(date-time)

When the event was emitted

type

string

Type of the event

workspace

object

Workspace context

1 Items

Example Catalog Product Group Created Event Payload

JSON

{
  "id": "catalog_123e4567-e89b-12d3-a456-426614174000",
  "productGroup": {
    "id": "wd8ML6JP"
  },
  "timestamp": "2025-09-25T14:53:39Z",
  "type": "v1.catalog.product_group.created",
  "workspace": {
    "id": "123456789"
  }
}

id

string

Unique event identifier

productGroup

object

The product group that was updated

1 Items

timestamp

string

(date-time)

When the event was emitted

type

string

Type of the event

workspace

object

Workspace context

1 Items

Example Catalog Product Group Updated Event Payload

JSON

{
  "id": "catalog_132e63d2-k4sp-543k-t42a-859430200123",
  "productGroup": {
    "id": "be5Kl6RE"
  },
  "timestamp": "2025-10-27T14:53:39Z",
  "type": "v1.catalog.product_group.updated",
  "workspace": {
    "id": "431236"
  }
}

id

string

Unique identifier for this catalog update event

product

object

Product affected by the rate change

1 Items

rate

object

Rate definition for the product

3 Items

timestamp

string

(date-time)

When the event occurred

type

string

Type of the event

workspace

object

Workspace context

1 Items

Example Product Rate Updated Event Payload

JSON

{
  "id": "catalog_0fb93e74-6d4d-4a06-863a-d1a7020ce456",
  "product": {
    "id": "VecTmh6k"
  },
  "rate": {
    "calendar": [
      {
        "amount_cents": 20000,
        "span": {
          "from": "-Infinity",
          "to": "+Infinity"
        }
      }
    ],
    "currency": "GBP",
    "interval": "WEEKLY"
  },
  "timestamp": "2025-08-18T12:36:51Z",
  "type": "v1.catalog.product_rate.updated",
  "workspace": {
    "id": "1234567890"
  }
}

company

object

Information about the created company

1 Items

crmNamespace

object

CRM namespace context for the company

1 Items

id

string

Unique event identifier

type

string

Type of the event

Example CRM Company Created Event Payload

JSON

{
  "company": {
    "id": "1234567890"
  },
  "crmNamespace": {
    "id": "b7ecdf83-ed58-449a-98b5-bca3569703e4"
  },
  "id": "crm_6f47ff5c-0e91-476a-a4d8-8ae677c125cb",
  "type": "v1.crm.company.created"
}

company

object

Information about the updated company

1 Items

crmNamespace

object

CRM namespace context for the company

1 Items

id

string

Unique event identifier

type

string

Type of the event

Example CRM Company Updated Event Payload

JSON

{
  "company": {
    "id": "1234567890"
  },
  "crmNamespace": {
    "id": "b7ecdf83-ed58-449a-98b5-bca3569703e4"
  },
  "id": "crm_6f47ff5c-0e91-476a-a4d8-8ae677c125cb",
  "type": "v1.crm.company.updated"
}

contact

object

Information about the created contact

8 Items

crmNamespace

object

CRM namespace context for the contact

1 Items

id

string

Unique event identifier

type

string

Type of the event

Example CRM Contact Created Event Payload

JSON

{
  "contact": {
    "firstName": "John",
    "id": "1234567890",
    "lastName": "Smith",
    "primaryEmail": "john.smith@getlavanda.com",
    "primaryPhoneNumber": "+447999999999",
    "reference": "KTPB9G8G-01",
    "secondaryEmails": [],
    "secondaryPhoneNumbers": []
  },
  "crmNamespace": {
    "id": "b7ecdf83-ed58-449a-98b5-bca3569703e4"
  },
  "id": "crm_a052a39b-1fdd-4c25-ae28-f83140ef0527",
  "type": "v1.crm.contact.created"
}

contact

object

Updated contact information

8 Items

crmNamespace

object

CRM namespace context for the contact

1 Items

id

string

Unique event identifier

type

string

Type of the event

Example CRM Contact Updated Event Payload

JSON

{
  "contact": {
    "firstName": "John",
    "id": "1234567890",
    "lastName": "Smith",
    "primaryEmail": "john.smith@getlavanda.com",
    "primaryPhoneNumber": "+447999999999",
    "reference": "KTPB9G8G-01",
    "secondaryEmails": [],
    "secondaryPhoneNumbers": []
  },
  "crmNamespace": {
    "id": "b7ecdf83-ed58-449a-98b5-bca3569703e4"
  },
  "id": "crm_c9ffc006-35bc-497a-b48f-08e2d1a0fe69",
  "type": "v1.crm.contact.updated"
}

crmNamespace

object

CRM namespace context for the lead

1 Items

id

string

Unique event identifier

lead

object

Lead data

13 Items

type

string

Type of the event

workspace

object

Workspace(s) associated with the lead

1 Items

Example CRM Lead Created Event Payload

JSON

{
  "crmNamespace": {
    "id": "b7ecdf83-ed58-449a-98b5-bca3569703e4"
  },
  "id": "crm_74911d0f-b88d-45d0-b909-6c5baa868040",
  "lead": {
    "contacts": [
      {
        "contact": {
          "firstName": "John",
          "lastName": "Smith",
          "primaryEmail": "john.smith@getlavanda.com"
        },
        "role": "LEAD_GUEST"
      }
    ],
    "createdAt": 1758626865537,
    "estimatedCheckIn": null,
    "estimatedCheckOut": null,
    "id": "1234567890",
    "origin": "https://www.getlavanda.com",
    "reference": "ABACAD-01",
    "source": "Lavanda",
    "status": "NEW",
    "totalAdults": 2,
    "totalBeds": 1,
    "totalChildren": 1,
    "totalUnits": 1
  },
  "type": "v1.crm.lead.created",
  "workspace": {
    "ids": [
      "7536406e-679e-4e65-8892-b01ecfda865d"
    ]
  }
}

crmNamespace

object

CRM namespace context for the lead

1 Items

id

string

Unique event identifier

lead

object

Lead data

13 Items

type

string

Type of the event

workspace

object

Workspace(s) associated with the lead

1 Items

Example CRM Lead Updated Event Payload

JSON

{
  "crmNamespace": {
    "id": "b7ecdf83-ed58-449a-98b5-bca3569703e4"
  },
  "id": "crm_97df50e7-15c9-4fb8-ba9d-4f39598da78b",
  "lead": {
    "contacts": [
      {
        "contact": {
          "firstName": "John",
          "lastName": "Smith",
          "primaryEmail": "john.smith@getlavanda.com"
        },
        "role": "LEAD_GUEST"
      }
    ],
    "createdAt": 1758626865537,
    "estimatedCheckIn": null,
    "estimatedCheckOut": null,
    "id": "1234567890",
    "origin": "https://www.getlavanda.com",
    "reference": "ABACAD-01",
    "source": "Lavanda",
    "status": "CONTACTED",
    "totalAdults": 2,
    "totalBeds": 1,
    "totalChildren": 1,
    "totalUnits": 1
  },
  "type": "v1.crm.lead.status_updated",
  "workspace": {
    "ids": [
      "1234567890"
    ]
  }
}

crmNamespace

object

CRM namespace context for the lead

1 Items

id

string

Unique event identifier

lead

object

Lead data

13 Items

type

string

Type of the event

workspace

object

Workspace(s) associated with the lead

1 Items

Example CRM Lead Updated Event Payload

JSON

{
  "crmNamespace": {
    "id": "b7ecdf83-ed58-449a-98b5-bca3569703e4"
  },
  "id": "crm_7a714761-eff9-4495-a593-83af4576987e",
  "lead": {
    "contacts": [
      {
        "contact": {
          "firstName": "John",
          "lastName": "Smith",
          "primaryEmail": "john.smith@getlavanda.com"
        },
        "role": "LEAD_GUEST"
      }
    ],
    "createdAt": 1758626865537,
    "estimatedCheckIn": null,
    "estimatedCheckOut": null,
    "id": "1234567890",
    "origin": "https://www.getlavanda.com",
    "reference": "ABACAD-01",
    "source": "Lavanda",
    "status": "CLOSED_WON",
    "totalAdults": 2,
    "totalBeds": 1,
    "totalChildren": 1,
    "totalUnits": 1
  },
  "type": "v1.crm.lead.updated",
  "workspace": {
    "ids": [
      "1234567890"
    ]
  }
}

building

object

Building information

1 Items

id

string

The unique identifier for the event

type

string

The type of event

workspace

object

Workspace that the building belongs to

1 Items

Example Building Created Event Payload

JSON

{
  "building": {
    "id": "1234567890"
  },
  "id": "spaces_b7bd58d8-af22-4ad1-9903-55e8094f7707",
  "type": "v1.spaces.building.created",
  "workspace": {
    "id": "1234567890"
  }
}

building

object

Building information

1 Items

id

string

The unique identifier for the event

type

string

The type of event

workspace

object

Workspace that the building belongs to

1 Items

Example Building Updated Event Payload

JSON

{
  "building": {
    "id": "1234567890"
  },
  "id": "spaces_51b04fc8-b968-4824-bfa7-6c2d04566aa1",
  "type": "v1.spaces.building.updated",
  "workspace": {
    "id": "1234567890"
  }
}

id

string

The unique identifier for the event

type

string

The type of event

unit

object

Unit information

1 Items

workspace

object

Workspace that the unit belongs to

1 Items

Example Unit Created Event Payload

JSON

{
  "id": "spaces_f58e9311-73cc-4b0f-8b25-725b1c9e66a4",
  "type": "v1.spaces.unit.created",
  "unit": {
    "id": "1234567890"
  },
  "workspace": {
    "id": "1234567890"
  }
}

id

string

The unique identifier for the event

type

string

The type of event

unit

object

Unit information

1 Items

workspace

object

Workspace that the unit belongs to

1 Items

Example Unit Updated Event Payload

JSON

{
  "id": "spaces_b2458089-31f0-49fd-b3d4-6112b75420b4",
  "type": "v1.spaces.unit.updated",
  "unit": {
    "id": "1234567890"
  },
  "workspace": {
    "id": "1234567890"
  }
}

id

string

Unique identifier for the task creation event

task

object

The created task

1 Items

type

string

Type of the event

workspace

object

Workspace context for the task

1 Items

Example Tickets Task Created Event Payload

JSON

{
  "id": "tickets_tasks_82bc50ca-d3e5-43b1-a962-b05fc50c8ac5",
  "task": {
    "id": "1234567890"
  },
  "type": "v1.tickets_tasks.task.created",
  "workspace": {
    "id": "1234567890"
  }
}

id

string

Unique identifier for the task update event

task

object

The updated task

1 Items

type

string

Type of the event

workspace

object

Workspace context for the task

1 Items

Example Tickets Task Updated Event Payload

JSON

{
  "id": "tickets_tasks_afcc4cfd-243f-46a0-a2d4-7869a9e78cbe",
  "ticket": {
    "id": "1234567890"
  },
  "type": "v1.tickets_tasks.task.updated",
  "workspace": {
    "id": "1234567890"
  }
}

id

string

Unique identifier for the ticket creation event

ticket

object

The created ticket

1 Items

type

string

Type of the event

workspace

object

Workspace context for the ticket

1 Items

Example Tickets Ticket Created Event Payload

JSON

{
  "id": "tickets_tasks_c67cf33c-86a4-4c9a-abb2-2521f30604ab",
  "ticket": {
    "id": "1234567890"
  },
  "type": "v1.tickets_tasks.ticket.created",
  "workspace": {
    "id": "1234567890"
  }
}

id

string

Unique identifier for the ticket update event

ticket

object

The updated ticket

1 Items

type

string

Type of the event

workspace

object

Workspace context for the ticket

1 Items

Example Tickets Ticket Updated Event Payload

JSON

{
  "id": "tickets_tasks_346970e1-2680-4db2-8da6-6e24780aa5dc",
  "ticket": {
    "id": "1234567890"
  },
  "type": "v1.tickets_tasks.ticket.updated",
  "workspace": {
    "id": "1234567890"
  }
}