Customer Updated V1

View JSON Schema

A message that is sent when a customer is updated. The message contains information about the customer, the customer categories, the customer memberships and the facility that the customer was updated for. This event is triggered when a customer is updated. It is only sent for customers that have an email address, a first name and a last name. 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
customer	`object`	Customer	Customer information	yes
customerCategories	`object[]`	CustomerCategories	List of customer categories	no
customerMemberships	`object[]`	CustomerMemberships	The customer’s active membership, if any. The list holds at most one membership.	no
facility	`object`	Facility	Facility information	yes

Example

{
    "customer": {
        "customerId": "12345",
        "userId": "123e4567-e89b-12d3-a456-426614174000",
        "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": true,
        "registrationDate": "2023-01-01T12:00:00+01:00"
    },
    "customerCategories": [
        {
            "categoryId": "cat123",
            "categoryName": "Premium"
        }
    ],
    "customerMemberships": [
        {
            "membershipId": "mem123",
            "membershipName": "Gold"
        }
    ],
    "facility": {
        "facilityId": "2344123",
        "facilityName": "Matchi Tennis Club"
    }
}

customer: Customer

Customer information

Properties

Name	Type	Title	Description	Required
customerId	`string`	Customer ID	A unique identifier for the customer.	yes
userId	`string`	User ID	The MATCHi user id of the account linked to this customer, present only while the customer is linked to an account. The link can be removed (for example when the customer is archived) or replaced, so read it from each event. Booking events can carry a different userId for the same person (see Player and Owner), so do not join events on userId alone.Format: `"uuid"`	no
firstName	`string`	First Name	The first name of the customer.	no
lastName	`string`	Last Name	The last name of the customer.	no
email	`string`	Email	The email address of the customer, in a valid email format.Format: `"email"`	no
address	`string`	Address	The street address of the customer.	no
city	`string`	City	The city where the customer resides.	no
zipcode	`string`	Zipcode	The postal code of the customer’s address.	no
country	`string`	Country	The country where the customer resides.	no
nationality	`string`	Nationality	The nationality of the customer.	no
cellphone	`string`	Cellphone	The cellphone number of the customer.	no
telephone	`string`	Telephone	The telephone number of the customer.	no
dateOfBirth	`string`	Date of Birth	The date of birth of the customer, in YYYY-MM-DD format.Format: `"date"`	no
gender	`string`	Gender	The gender of the customer: MALE, FEMALE, OTHER or NOT_SPECIFIED. Absent for organizations.	no
isOrganization	`boolean`	Is Organization	Indicates whether the customer is an organization.	no
doNotEmail	`boolean`	Do Not Email	Indicates whether the customer should not receive emails from facility.	no
registrationDate	`string`	Registration Date	The date and time when the customer registered, in ISO 8601 format. The time is the facility’s local time, with its UTC offset included.Format: `"date-time"`	no

Example

{
    "customerId": "12345",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "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": true,
    "registrationDate": "2023-01-01T12:00:00+01:00"
}

customerCategories[]: CustomerCategories

List of customer categories

Items: CustomerCategory

Customer category information

Item Properties

Name	Type	Title	Description	Required
categoryId	`string`	Category ID	A unique identifier for the customer category.	yes
categoryName	`string`	Category Name	The name of the customer category.	yes

Example

[
    {
        "categoryId": "cat123",
        "categoryName": "Premium"
    }
]

customerMemberships[]: CustomerMemberships

The customer’s active membership, if any. The list holds at most one membership.

Items: CustomerMembership

Customer membership information

Item Properties

Name	Type	Title	Description	Required
membershipId	`string`	Membership ID	A unique identifier for the membership.	yes
membershipName	`string`	Membership Name	The name of the membership.	yes

Example

[
    {
        "membershipId": "mem123",
        "membershipName": "Gold"
    }
]

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"
}