booking.completed

When it fires

Way sends booking.completed when a booking is confirmed - after the payment (or the selected payment method’s confirmation step) is processed successfully. This includes bookings created individually through checkout as well as bookings created in bulk. Events arrive at your endpoint as a POST request with the body { "event": "booking.completed", "payload": { ... } }. When a webhook secret is set, the X-Way-Signature header carries an HMAC of the request body - see Verify signatures.

Payload

Field	Type	Description
`brand.id`	string (UUID)	Unique identifier of the brand.
`brand.name`	string	Display name of the brand.
`brand.tier`	string	Subscription tier of the brand.
`brand.countryCode`	string	Country code of the brand.
`brand.currency`	string	Currency code used by the brand.
`brand.externalReferenceId`	string \| null	External reference identifier configured for the brand.
`addOns`	array	Add-ons purchased with the booking.
`addOns[].id`	string (UUID)	Unique identifier of the add-on item.
`addOns[].label`	string	Display label of the add-on.
`addOns[].price`	number	Unit price of the add-on.
`addOns[].paidAmount`	number	Amount paid for the add-on.
`addOns[].taxes[].id`	string (UUID)	Unique identifier of the applied tax entry.
`addOns[].taxes[].included`	boolean	Whether the tax is included in the price.
`addOns[].taxes[].paidAmount`	number	Tax amount paid.
`addOns[].taxes[].tax.id`	string (UUID)	Unique identifier of the tax.
`addOns[].taxes[].tax.name`	string	Name of the tax.
`bookingId`	string (UUID)	Unique identifier of the booking.
`bookingConfirmationCode`	string	Human-readable confirmation code of the booking.
`cartId`	string (UUID) \| null	Identifier of the cart the booking was purchased in, if any.
`cartConfirmationCode`	string \| null	Confirmation code of the cart, if any.
`experience.id`	string (UUID)	Unique identifier of the experience.
`experience.title`	string	Title of the experience.
`experience.startDateTime`	string	Local start date and time of the booked session.
`experience.duration.duration`	string	Session duration in ISO 8601 format (for example, `PT2H`).
`experience.location.id`	string (UUID)	Unique identifier of the location.
`experience.location.name`	string	Display name of the location.
`experience.location.additionalInfo`	string \| null	Extra directions or meeting instructions.
`experience.location.city`	string \| null	City of the location.
`experience.location.state`	string \| null	State of the location.
`experience.location.country`	string \| null	Country of the location.
`experience.location.latitude`	number	Latitude of the location.
`experience.location.longitude`	number	Longitude of the location.
`experience.location.timezoneId`	string	IANA time zone of the location.
`participantsCount`	number	Total number of participants on the booking.
`participants[].id`	string	Unique identifier of the participant.
`participants[].firstName`	string	First name of the participant.
`participants[].lastName`	string	Last name of the participant.
`participants[].priceTierName`	string	Name of the price tier the participant booked.
`participants[].priceTierId`	string	Identifier of the price tier the participant booked.
`participants[].emailAddress`	string \| null	Email address of the participant.
`participants[].phoneNumber`	string \| null	Phone number of the participant.
`participants[].answerIds`	string[]	Identifiers of the participant’s custom question answers, when present.
`participants[].bookingHistoryId`	string \| null	Identifier of the booking history entry that added the participant.
`priceTiers[].id`	string	Unique identifier of the price tier.
`priceTiers[].name`	string	Name of the price tier.
`priceTiers[].price`	number	Unit price of the tier.
`priceTiers[].amount`	number	Total amount for the tier on this booking.
`priceTiers[].participantsCount`	number	Number of participants booked on the tier.
`purchaser.fullName`	string	Full name of the purchaser.
`purchaser.firstName`	string	First name of the purchaser.
`purchaser.lastName`	string	Last name of the purchaser.
`purchaser.emailAddress`	string	Email address of the purchaser.
`purchaser.phoneNumber`	string \| null	Phone number of the purchaser.
`metadata`	object \| null	Custom metadata attached to the booking at checkout.
`loyaltyMemberId`	string \| null	Loyalty member identifier of the purchaser, if any.
`externalAnalyticsUserId`	string \| null	External analytics user identifier, if any.
`paymentMethod`	string	Payment method used: `credit-card`, `room-charge`, `member-number`, `loyalty`, `kicc`, `cash`, `pay-later`, or `pay-upon-arrival`.
`paymentDetail`	object	Payment details; may include `lastName`, `methodNumber`, and `reservationId` depending on the payment method.
`discountAmount`	number	Discount amount applied to the booking.
`notes`	string \| null	Guest notes attached to the booking.
`mode`	string	Booking mode: `private` or `shared`.
`amount`	number	Total amount of the booking.
`completedAt`	string (ISO 8601)	Timestamp when the booking was completed.
`bookingSourceUrl`	string \| null	URL of the page where the booking originated.
`siteLanguage`	string \| null	Language of the site the booking was made on.
`loyaltyTransactionId`	string \| null	Identifier of the associated loyalty transaction, if any.

Sample

{
  "event": "booking.completed",
  "payload": {
    "mode": "shared",
    "brand": {
      "id": "8e12bfdc-a74c-48e2-8a76-2996a359c10c",
      "name": "The Seaside Hotel",
      "tier": "growth",
      "currency": "USD",
      "countryCode": "US",
      "externalReferenceId": "ABC"
    },
    "notes": null,
    "addOns": [],
    "amount": 165,
    "cartId": "5a8a3e57-cf43-4473-8fec-422809da78f7",
    "metadata": null,
    "bookingId": "a4b16eba-f47a-49da-be4f-b6f9e1c01dec",
    "purchaser": {
      "fullName": "Alice Rivera",
      "lastName": "Smith",
      "firstName": "Alice",
      "phoneNumber": "+15550100",
      "emailAddress": "alice@example.com"
    },
    "experience": {
      "id": "7a78a18a-aa8f-456b-9fef-b43e0814401d",
      "title": "Guided Coastal Hike",
      "duration": {
        "duration": "PT2H"
      },
      "location": {
        "id": "2d786cca-8596-4c47-8b16-0c8e50451d77",
        "city": "Austin",
        "name": "Austin, TX, USA",
        "state": "TX",
        "country": "United States",
        "latitude": 30.267153,
        "createdAt": "2026-02-13T01:16:24.658Z",
        "longitude": -97.7430608,
        "updatedAt": "2026-02-13T01:16:24.658Z",
        "timezoneId": "America/Chicago",
        "additionalInfo": "Please meet on the beach"
      },
      "startDateTime": "2026-02-21T14:00"
    },
    "priceTiers": [
      {
        "id": "1e067a99-cc18-4e18-a514-0d64b05b5a95",
        "name": "Adult",
        "price": 100,
        "amount": 100,
        "participantsCount": 1
      },
      {
        "id": "7a9d0374-c24d-436c-b07b-c308737e20f3",
        "name": "Child",
        "price": 50,
        "amount": 50,
        "participantsCount": 1
      }
    ],
    "completedAt": "2026-02-13T01:17:45.631Z",
    "participants": [
      {
        "id": "f5130f1c-d9c7-42c5-a873-4fae31dc1aec",
        "lastName": "Smith",
        "firstName": "Alice",
        "phoneNumber": null,
        "priceTierId": "1e067a99-cc18-4e18-a514-0d64b05b5a95",
        "emailAddress": null,
        "priceTierName": "Adult",
        "bookingHistoryId": "805fcac7-747a-470d-b45f-b046b72ed68a"
      },
      {
        "id": "75040b2b-fff5-498b-a52a-c8012b605900",
        "lastName": "Smith",
        "firstName": "Suzie",
        "phoneNumber": null,
        "priceTierId": "7a9d0374-c24d-436c-b07b-c308737e20f3",
        "emailAddress": null,
        "priceTierName": "Child",
        "bookingHistoryId": "805fcac7-747a-470d-b45f-b046b72ed68a"
      }
    ],
    "siteLanguage": null,
    "paymentDetail": {},
    "paymentMethod": "credit-card",
    "discountAmount": 0,
    "loyaltyMemberId": null,
    "bookingSourceUrl": "https://embed-demo.staging.letsway.com/brands/8e12bfdc-a74c-48e2-8a76-2996a359c10c#!/checkout",
    "participantsCount": 2,
    "cartConfirmationCode": "mAOxREWCU",
    "loyaltyTransactionId": null,
    "bookingConfirmationCode": "wU3gwz0bJ",
    "externalAnalyticsUserId": null
  }
}

Retrieve the full booking with Get Booking.

​When it fires

​Payload

​Sample

​Related endpoints

When it fires

Payload

Sample

Related endpoints