Schema
Graph AI EngineCore Entity

Customer

The root guest identity node. Every interaction across bookings, Wi-Fi, orders, reviews, and loyalty is unified under a single Customer node per organisation.

15 fields28 relationships

Fields

NameTypeReqDescription
emailstringyesPrimary identifier, unique within an organisation.
first_namestringGuest first name.
last_namestringGuest last name.
phonestringPhone number in E.164 format, e.g. +447307745845.
postcodestringPostal code for geographic segmentation.
countrystringFull country name.
country_codestringISO 3166-1 alpha-2 code, e.g. GB.
genderenumStated gender. Allowed values: male | female | non_binary | prefer_not_to_say.
age_rangestringAge band string, e.g. 25-34 or 35-44.
birth_monthnumberMonth of birth, integer 1–12. Used to trigger birthday campaigns.
birth_daynumberDay of birth, integer 1–31.
org_iduuidOwning organisation. Always scope queries through the REGISTERED_WITH relationship.
morpheus_profile_iduuidInternal CRM (Morpheus) profile ID.
zion_iduuidBooking system (Zion) guest ID.
trinity_org_reg_iduuidOrganisation registration ID from the Trinity system.

Relationships

Outbound (28)
  • Customer[:REGISTERED_WITH]Organizationemail_opt_in, sms_opt_in, data_opt_in, registered_at, last_interacted_at
  • Customer[:VISITED]Venuevisit_count, first_visit, last_visit, total_spend (pennies)
  • Customer[:BOOKED]Bookingcreated_at
  • Customer[:INVITED_TO]Bookingstatus (PENDING | ACCEPTED | DECLINED)
  • Customer[:REVIEWED]Reviewcreated_at
  • Customer[:ORDERED]Ordercreated_at, amount (pennies)
  • Customer[:PLACED_ORDER]SquareOrder
  • Customer[:CONTRIBUTED_TO]SquareOrderamount (pennies), status, is_lead, payment_method
  • Customer[:CONNECTED_VIA_WIFI]WifiSessioncreated_at
  • Customer[:SUBMITTED]FormSubmissioncreated_at
  • Customer[:COMMUNICATED_IN]Thread
  • Customer[:ENROLLED_IN]LoyaltyEnrollmentenrolled_at, points
  • Customer[:TAGGED_WITH]Tag
  • Customer[:RECEIVED_CAMPAIGN]EmailCampaignsent_at
  • Customer[:OPENED_CAMPAIGN]EmailCampaignopened_at
  • Customer[:CLICKED_CAMPAIGN]EmailCampaignclicked_at, link_url
  • Customer[:BOUNCED_CAMPAIGN]EmailCampaignbounced_at
  • Customer[:RECEIVED_SMS]SmsCampaignsent_at
  • Customer[:IN_SEGMENT]Segment
  • Customer[:ANSWERED]CustomQuestionanswer
  • Customer[:SENT_GIFT_CARD]GiftCardamount (pennies), currency, created_at
  • Customer[:REDEEMED_GIFT_CARD]GiftCardredeemed_at
  • Customer[:CHARGED_CANCELLATION]CancellationChargeamount_owed (pennies)
  • Customer[:BOOKED_VIA_INTEGRATION]BookingIntegrationpenny_value, currency, created_at
  • Customer[:REFERRED]Customer
  • Customer[:DINED_WITH]Customerbooking_id, date
  • Customer[:GIFTED_TO]Customergift_name, value (pennies), sent_at
  • Customer[:ENQUIRED]Enquirycreated_at