Booking Created V1

View JSON Schema

(DEPRECATED) DEPRECATED — superseded by BookingCreatedV2, which adds bookingType, entityId and activityDetail and also covers activity, subscription, training and match bookings. V1 continues to be emitted unchanged during the migration window and is scheduled for removal; new integrations should subscribe to BOOKING_CREATED_V2. A message that is sent when a booking is created. The message contains information about the booking, the owner of the booking, the facility that the booking was made for and the players that are included in the booking. This event is triggered when a booking is created.This is data part of the message please read the event section for more information of the metadata envelop.

Properties

Name	Type	Title	Description	Required
issuerId	`string`	Issuer ID	Not populated for booking events; the field is always absent.Format: `"uuid"`	no
players	`object[]`	Players	List of players	yes
owner	`object`	Owner	Booking owner information	yes
booking	`object`	Booking		yes
facility	`object`	Facility	Facility information	yes

Example

{
    "players": [
        {
            "userId": "550e8400-e29b-41d4-a716-446655440000",
            "email": "john.doe@example.com",
            "isCustomer": false,
            "telephone": "1234567890",
            "cellphone": "0987654321",
            "firstName": "John",
            "lastName": "Doe",
            "customerId": "123456"
        }
    ],
    "owner": {
        "customerId": "CUST123456",
        "userId": "550e8400-e29b-41d4-a716-446655440000",
        "firstName": "John",
        "lastName": "Doe",
        "email": "john.doe@example.com",
        "address": "123 Main St",
        "city": "Anytown",
        "zipcode": "12345",
        "country": "USA",
        "nationality": "American",
        "cellphone": "+1234567890",
        "telephone": "+0987654321",
        "dateOfBirth": "1980-01-01",
        "gender": "MALE",
        "isOrganization": false,
        "doNotEmail": false,
        "registrationDate": "2023-07-04T10:00:00+02:00"
    },
    "booking": {
        "bookingId": "1234555",
        "startTime": "2024-07-04T10:00:00+02:00",
        "endTime": "2024-07-04T11:00:00+02:00",
        "courtId": "C001",
        "courtName": "Main Court",
        "accessCode": "ACCESS1234",
        "splitPayment": true,
        "internalNotes": "This note is hidden from customers",
        "externalNotes": "9025 Vuxenkurs",
        "externalPayment": false,
        "totalPrice": "1000.00"
    },
    "facility": {
        "facilityId": "2344123",
        "facilityName": "Matchi Tennis Club"
    }
}

players[]: Players

List of players

Items: Player

Player information

Item Properties

Name	Type	Title	Description	Required
customerId	`string`	Customer ID	A unique identifier for the customer.	no
userId	`string`	User ID	The player’s MATCHi user id, present only when an account is found. It is looked up by the player’s email first (or the customer’s email when the player has none), then by the account linked to the player’s customer, so it can differ from the userId in customer events for the same customer.Format: `"uuid"`	no
firstName	`string`	First Name	The first name of the player.	no
lastName	`string`	Last Name	The last name of the player.	no
cellphone	`string`	Cellphone	The cellphone number of the player.	no
telephone	`string`	Telephone	The telephone number of the player.	no
email	`string`	Email	The email address of the player, in a valid email format.Format: `"email"`	no
isCustomer	`boolean`	Is Customer	Indicates whether the player is a customer.	yes

Example

[
    {
        "userId": "550e8400-e29b-41d4-a716-446655440000",
        "email": "john.doe@example.com",
        "isCustomer": false,
        "telephone": "1234567890",
        "cellphone": "0987654321",
        "firstName": "John",
        "lastName": "Doe",
        "customerId": "123456"
    }
]

owner: Owner

Booking owner information

Properties

Name	Type	Title	Description	Required
customerId	`string`	Customer ID	A unique identifier for the customer.	yes
userId	`string`	User ID	A MATCHi user id for the booking owner: the account linked to the booking’s customer. When that customer has no account, it is the user who placed the booking’s order (bookings made by the facility usually have none) or, in V2 events for subscription bookings, the account linked to the subscription’s customer. Absent when none of these exists.Format: `"uuid"`	no
firstName	`string`	First Name	The first name of the booking owner.	no
lastName	`string`	Last Name	The last name of the booking owner.	no
email	`string`	Email	The email address of the booking owner, in a valid email format.Format: `"email"`	no
address	`string`	Address	The street address of the booking owner.	no
city	`string`	City	The city where the booking owner resides.	no
zipcode	`string`	Zipcode	The postal code of the booking owner’s address.	no
country	`string`	Country	The country where the booking owner resides.	no
nationality	`string`	Nationality	The nationality of the booking owner.	no
cellphone	`string`	Cellphone	The cellphone number of the booking owner.	no
telephone	`string`	Telephone	The telephone number of the booking owner.	no
dateOfBirth	`string`	Date of Birth	The date of birth of the booking owner, in YYYY-MM-DD format.Format: `"date"`	no
gender	`string`	Gender	The gender of the booking owner: MALE, FEMALE, OTHER or NOT_SPECIFIED. Absent for organizations.	no
isOrganization	`boolean`	Is Organization	Indicates whether the booking owner is an organization.	no
doNotEmail	`boolean`	Do Not Email	Indicates whether the booking owner should not receive emails from facility.	no
registrationDate	`string`	Registration Date	The date and time when the booking owner registered, in ISO 8601 format. The time is the facility’s local time, with its UTC offset included.Format: `"date-time"`	no

Example

{
    "customerId": "CUST123456",
    "userId": "550e8400-e29b-41d4-a716-446655440000",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "address": "123 Main St",
    "city": "Anytown",
    "zipcode": "12345",
    "country": "USA",
    "nationality": "American",
    "cellphone": "+1234567890",
    "telephone": "+0987654321",
    "dateOfBirth": "1980-01-01",
    "gender": "MALE",
    "isOrganization": false,
    "doNotEmail": false,
    "registrationDate": "2023-07-04T10:00:00+02:00"
}

booking: Booking

Properties

Name	Type	Title	Description	Required
bookingId	`string`	Booking ID	A unique identifier for the booking.	yes
startTime	`string`	Start Time	The start time of the booking, in ISO 8601 format. The time is the facility’s local time, with its UTC offset included.Format: `"date-time"`	yes
endTime	`string`	End Time	The end time of the booking, in ISO 8601 format. The time is the facility’s local time, with its UTC offset included.Format: `"date-time"`	yes
courtId	`string`	Court ID	A unique identifier for the court.	yes
courtName	`string`	Court Name	The name of the court.	yes
accessCode	`string`	Access Code	A code to access the court.	no
splitPayment	`boolean`	Split Payment	Indicates whether the booking type is a split payment booking.	no
internalNotes	`string`	Internal Notes	The comments/notes on the booking which should be hidden from players.	no
externalNotes	`string`	External Notes	The comments/notes on the booking which should be shown to players.	no
externalPayment	`boolean`	External Payment	Indicates whether the booking requires an external provider payment (f.ex: TPC payment gateway).	no
totalPrice	`string`	Total Price	The total price of the booking, including VAT, with refunds and promo codes subtracted. It is the order price, not the amount the customer actually paid. Absent when the booking has no order.	no

Example

{
    "bookingId": "1234555",
    "startTime": "2024-07-04T10:00:00+02:00",
    "endTime": "2024-07-04T11:00:00+02:00",
    "courtId": "C001",
    "courtName": "Main Court",
    "accessCode": "ACCESS1234",
    "splitPayment": true,
    "internalNotes": "This note is hidden from customers",
    "externalNotes": "9025 Vuxenkurs",
    "externalPayment": false,
    "totalPrice": "1000.00"
}

facility: Facility

Facility information

Properties

Name	Type	Title	Description	Required
facilityId	`string`	Facility ID	A unique identifier for the facility.	yes
facilityName	`string`	Facility Name	The name of the facility.	yes

Example

{
    "facilityId": "2344123",
    "facilityName": "Matchi Tennis Club"
}