Breaking changes

This page lists past and planned changes to the EventsAir GraphQL API that may impact integrated applications. While we endeavour to maintain backward compatibility as the API evolves, scenarios may arise that require a breaking change.

This page is intended to provide advanced notice of breaking changes so that developers can plan ahead to test their integrated applications and make any necessary changes.

Planned breaking changes

Future

The following changes are planned for release at some point in the future, but have not been scheduled yet. Typically, these are fields that have been deprecated in the GraphQL API. We will update this page with details of when these changes will be completed.

• The address input field on input types UpdateContactDetailsInput, UpdateContactStoreContactDetailsInput, UpdateCeContactStoreContactDetailsInput and UpdateMembershipContactStoreContactDetailsInput has been deprecated and will be removed in a future release. Please use the new primaryAddress field instead.
• The field userAccessRights on object types Event, ContactStore, CeContactStore and MembershipContactStore has been deprecated and will be removed in a future release. Please use the new accessRights field instead.
• The attachedDocumentIds input field on input type CreatePresentationInput has been deprecated and will be removed in a future release. Please use the new attachedDocuments field instead.
• The attachedDocumentIds input field on input type UpdatePresentationInput has been deprecated and will be removed in a future release. Please use the new attachedDocuments field instead.
• The input argument on object type FunctionRegistration has been deprecated and will be removed in a future release. Please use the new filterInput argument instead.
• The input argument on object type Registration has been deprecated and will be removed in a future release. Please use the new filterInput argument instead.
• The field reference on object type EventsAirPaymentsPaymentDetails has been deprecated and will be removed in a future release. Please use the new paymentId field instead.
• The field locations on object type PresentationSetup has been deprecated and will be removed in a future release. Please use the new setup.locations field instead.
• The field isCompleted on object type SponsorshipPackageItem has been deprecated and will be removed in a future release.
• The field name on object type SponsorshipPackageItem has been deprecated and will be removed in a future release. Please use the new inclusion.name field instead.
• The field value on object type SponsorshipPackageItem has been deprecated and will be removed in a future release. Please use the new inclusion.value field instead.
• The field contactId on object type CreatePresentationAuthorInput has been deprecated and will be removed in a future release. Please use the new contactAuthor field instead.
• The field contactId on object type UpdatePresentationAuthorInput has been deprecated and will be removed in a future release. Please use the new contactAuthor field instead.
• The field jobTitle on object type UpdateContactBillingInput has been deprecated and will be removed in a future release.
• The field jobTitle in object type UpdateContactStoreContactBillingInput has been deprecated and will be removed in a future release.
• The field jobTitle in object type UpdateCeContactStoreContactBillingInput has been deprecated and will be removed in a future release.
• The field jobTitle in object type UpdateMembershipContactStoreContactBillingInput has been deprecated and will be removed in a future release.
• The values PAYMENT and REFUND in enum InvoiceFinancialTransactionType have been deprecated and will be removed oin a future release.
• The field contacts in object type CeContactStore has been deprecated and will be removed in a future release. Please use contactsPaged field instead.
• The field courseRegistrations in object type CeContactStore has been deprecated and will be removed in a future release. Please use courseRegistrationsPaged field instead.
• The field customFields in object type CeContactStore has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field invoices in object type CeContactStore has been deprecated and will be removed in a future release. Please use invoicesPaged field instead.
• The field notes in object type CeContactStore has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field payments in object type CeContactStore has been deprecated and will be removed in a future release. Please use paymentsPaged field instead.
• The field courseRegistrations in object type CeContactStoreContact has been deprecated and will be removed in a future release. Please use courseRegistrationsPaged field instead.
• The field CeContactStoreContact.customFields in object type CeContactStoreContact has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field CeContactStoreContact.miscellaneousCharges in object type CeContactStoreContact has been deprecated and will be removed in a future release. Please use miscellaneousChargesPaged field instead.
• The field CeContactStoreContact.notes in object type CeContactStoreContact has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field customFields in object type CeContactStoreCourse has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type CeContactStoreCourseRegistration has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type CeContactStoreFunction has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field functionRegistrations in object type CeContactStoreFunction has been deprecated and will be removed in a future release. Please use functionRegistrationsPaged field instead.
• The field customFields in object type CeContactStoreFunctionRegistration has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type CeContactStoreMarketingRecord has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type CeContactStoreNote has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field noteTypes in object type CeContactStoreNoteSetup has been deprecated and will be removed in a future release. Please use noteTypesPaged field instead.
• The field notes in object type CeContactStoreNoteType has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field agendaItemAttendances in object type Contact has been deprecated and will be removed in a future release. Please use agendaItemAttendancesPaged field instead.
• The field courseRegistrations in object type Contact has been deprecated and will be removed in a future release. Please use courseRegistrationsPaged field instead.
• The field customFields in object type Contact has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field exhibitionBookings in object type Contact has been deprecated and will be removed in a future release. Please use exhibitionBookingsPaged field instead.
• The field functionRegistrations in object type Contact has been deprecated and will be removed in a future release. Please use functionRegistrationsPaged field instead.
• The field hotelBookings in object type Contact has been deprecated and will be removed in a future release. Please use hotelBookingsPaged field instead.
• The field miscellaneousCharges in object type Contact has been deprecated and will be removed in a future release. Please use miscellaneousChargesPaged field instead.
• The field notes in object type Contact has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field sponsorships in object type Contact has been deprecated and will be removed in a future release. Please use sponsorshipsPaged field instead.
• The field travelBookings in object type Contact has been deprecated and will be removed in a future release. Please use travelBookingsPaged field instead.
• The field customFields in object type ContactGroup has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field contacts in object type ContactStore has been deprecated and will be removed in a future release. Please use contactsPaged field instead.
• The field customFields in object type ContactStore has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field notes in object type ContactStore has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field customFields in object type ContactStoreContact has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field notes in object type ContactStoreContact has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field customFields in object type ContactStoreMarketingRecord has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type ContactStoreNote has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field noteTypes in object type ContactStoreNoteSetup has been deprecated and will be removed in a future release. Please use noteTypesPaged field instead.
• The field notes in object type ContactStoreNoteType has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field customFields in object type CourseClassification has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type CourseFeeType has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type CourseSubClassification has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field agendaItemAttendances in object type Event has been deprecated and will be removed in a future release. Please use agendaItemAttendancesPaged field instead.
• The field contacts in object type Event has been deprecated and will be removed in a future release. Please use contactsPaged field instead.
• The field courseRegistrations in object type Event has been deprecated and will be removed in a future release. Please use courseRegistrationsPaged field instead.
• The field customFields in object type Event has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field exhibitionBookings in object type Event has been deprecated and will be removed in a future release. Please use exhibitionBookingsPaged field instead.
• The field exhibitionFloorPlan in object type Event has been deprecated and will be removed in a future release. Please use exhibitionFloorPlanPaged field instead.
• The field functionRegistrations in object type Event has been deprecated and will be removed in a future release. Please use functionRegistrationsPaged field instead.
• The field hotelBookings in object type Event has been deprecated and will be removed in a future release. Please use hotelBookingsPaged field instead.
• The field invoices in object type Event has been deprecated and will be removed in a future release. Please use invoicesPaged field instead.
• The field notes in object type Event has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field payments in object type Event has been deprecated and will be removed in a future release. Please use paymentsPaged field instead.
• The field presentations in object type Event has been deprecated and will be removed in a future release. Please use presentationsPaged field instead.
• The field registrations in object type Event has been deprecated and will be removed in a future release. Please use registrationsPaged field instead.
• The field sessions in object type Event has been deprecated and will be removed in a future release. Please use sessionsPaged field instead.
• The field sponsorships in object type Event has been deprecated and will be removed in a future release. Please use sponsorshipsPaged field instead.
• The field travelBookings in object type Event has been deprecated and will be removed in a future release. Please use travelBookingsPaged field instead.
• The field customFields in object type EventCourse has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type EventCourseRegistration has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type EventMarketingGroup has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type EventMarketingRecord has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type EventMarketingSubTag has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type EventMarketingTag has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type EventNote has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field noteTypes in object type EventNoteSetup has been deprecated and will be removed in a future release. Please use noteTypesPaged field instead.
• The field customFields in object type EventNoteType has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field notes in object type EventNoteType has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field customFields in object type EventsAirMembershipRegistration has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type ExhibitionBooking has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type ExhibitionStandType has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type ExternalMembershipRegistration has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type Function has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type FunctionEventAgendaItem has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type FunctionFeeType has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type FunctionGroup has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type FunctionRegistration has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type Hotel has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type HotelBooking has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type MembershipCategory has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field contacts in object type MembershipContactStore has been deprecated and will be removed in a future release. Please use contactsPaged field instead.
• The field courseRegistrations in object type MembershipContactStore has been deprecated and will be removed in a future release. Please use courseRegistrationsPaged field instead.
• The field customFields in object type MembershipContactStore has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field invoices in object type MembershipContactStore has been deprecated and will be removed in a future release. Please use invoicesPaged field instead.
• The field membershipRegistrations in object type MembershipContactStore has been deprecated and will be removed in a future release. Please use membershipRegistrationsPaged field instead.
• The field notes in object type MembershipContactStore has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field payments in object type MembershipContactStore has been deprecated and will be removed in a future release. Please use paymentsPaged field instead.
• The field courseRegistrations in object type MembershipContactStoreContact has been deprecated and will be removed in a future release. Please use courseRegistrationsPaged field instead.
• The field customFields in object type MembershipContactStoreContact has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field membershipRegistrations in object type MembershipContactStoreContact has been deprecated and will be removed in a future release. Please use membershipRegistrationsPaged field instead.
• The field miscellaneousCharges in object type MembershipContactStoreContact has been deprecated and will be removed in a future release. Please use miscellaneousChargesPaged field instead.
• The field notes in object type MembershipContactStoreContact has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field customFields in object type MembershipContactStoreCourse has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type MembershipContactStoreCourseRegistration has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type MembershipContactStoreFunction has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field functionRegistrations in object type MembershipContactStoreFunction has been deprecated and will be removed in a future release. Please use functionRegistrationsPaged field instead.
• The field customFields in object type MembershipContactStoreFunctionRegistration has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type MembershipContactStoreMarketingRecord has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type MembershipContactStoreNote has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field noteTypes in object type MembershipContactStoreNoteSetup has been deprecated and will be removed in a future release. Please use noteTypesPaged field instead.
• The field notes in object type MembershipContactStoreNoteType has been deprecated and will be removed in a future release. Please use notesPaged field instead.
• The field customFields in object type Presentation has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type PresentationType has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type Registration has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type RegistrationGroup has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type RegistrationType has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type RoomType has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type Sector has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type Session has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type SessionAttendanceAgendaItem has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type SessionEventAgendaItem has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type SessionRole has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type Sponsorship has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field sponsorshipPackages in object type SponsorshipSetup has been deprecated and will be removed in a future release. Please use sponsorshipPackagesPaged field instead.
• The field customFields in object type Supplier has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type TravelBooking has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.
• The field customFields in object type TravelType has been deprecated and will be removed in a future release. Please use customFieldsPaged field instead.

Past breaking changes

The following sections list past releases of changes that may have impacted integrated applications.

2025-04-30

• The type for field SessionBlock.date will be changed LocalDate! to LocalDate
• The type for field SessionBlock.start will be changed LocalTime! to LocalTime
• The type for field SessionBlock.end will be changed LocalTime! to LocalTime

2025-02-25

• Fix an issue with createContact that allows a Contact to be created when the ID of a Contact Store is passed instead of an Event. Please use the correct mutations for Contact Stores.

  If you are working with a Contact Store you will need to replace the existing code of:

mutation CreateContact {
  createContact(
    input: {
      firstName: "John"
      lastName: "Smith"
      organizationName: "ACME Corporation"
      primaryEmail: "jsmith@acme.com"
      eventId: "d714ba51-34df-426f-a2d5-6d6ab41e0138"
    }
  ) {
    contact {
      internalNumber
      id
    }
  }
}

With:

mutation CreateContactStoreContact {
  createContactStoreContact(
    input: {
      firstName: "John"
      lastName: "Smith"
      organizationName: "ACME Corporation"
      primaryEmail: "jsmith@acme.com"
      contactStoreId: "d714ba51-34df-426f-a2d5-6d6ab41e0138"
    }
  ) {
    contact {
      internalNumber
      id
    }
  }
}

• Fix an issue with updateContactDetails that allows a Contact to be updated when the ID of a Contact Store is passed instead of an Event. Please use the correct mutations for Contact Stores

  If you are working with a Contact Store you will need to replace the existing code of:

mutation UpdateContactDetails {
  updateContactDetails(
    input: {
      contactId: "2D18FF0E-8D8A-4B31-A333-56EAAD456FAA"
      eventId: "d714ba51-34df-426f-a2d5-6d6ab41e0138"
      jobTitle: "VP Marketing"
    }
  ) {
    contact {
      internalNumber
      id
      firstName
      lastName
      jobTitle
      organizationName
    }
  }
}

With:

mutation UpdateContactStoreContactDetails {
  updateContactStoreContactDetails(
    input: {
      contactId: "2D18FF0E-8D8A-4B31-A333-56EAAD456FAA"
      contactStoreId: "d714ba51-34df-426f-a2d5-6d6ab41e0138"
      jobTitle: "VP Marketing"
    }
  ) {
    contact {
      internalNumber
      id
      firstName
      lastName
      jobTitle
      organizationName
    }
  }
}

• Fix an issue with updateContactBilling that allows a Contact to be updated when the ID of a Contact Store is passed instead of an Event. Please use the correct mutations for Contact Stores.

  If you are working with a Contact Store you will need to replace the existing code of:

mutation UpdateContactBilling {
  updateContactBilling(
    input: {
      contactId: "2D18FF0E-8D8A-4B31-A333-56EAAD456FAA"
      eventId: "d714ba51-34df-426f-a2d5-6d6ab41e0138"
      firstName: "Jane"
      lastName: "White"
      organizationName: "ACME Corporation"
      email: "jwhite@acme.com"
    }
  ) {
    contact {
      internalNumber
      id
      firstName
      lastName
      jobTitle
      organizationName
      billing {
        id
        firstName
        lastName
        organizationName
        email
      }
    }
  }
}

With:

mutation UpdateContactStoreContactBilling {
  updateContactStoreContactBilling(
    input: {
      contactId: "2D18FF0E-8D8A-4B31-A333-56EAAD456FAA"
      contactStoreId: "d714ba51-34df-426f-a2d5-6d6ab41e0138"
      firstName: "Jane"
      lastName: "White"
      organizationName: "ACME Corporation"
      email: "jwhite@acme.com"
    }
  ) {
    contact {
      internalNumber
      id
      firstName
      lastName
      jobTitle
      organizationName
      billing {
        id
        firstName
        lastName
        organizationName
        email
      }
    }
  }
}

• Field CeContactStore.functionRegistrations will change type from [FunctionRegistration!]! to [CeContactStoreFunctionRegistration!]!.-
• Field MembershipContactStore.functionRegistrations will change type from [FunctionRegistration!]! to [MembershipContactStoreFunctionRegistration!]!.
• Field MembershipContactStoreContact.functionRegistrations will change type from [FunctionRegistration!]! to [MembershipContactStoreFunctionRegistration!]!.

2024-06-07

The following changes are planned for release on 2024-06-05. If your integrated applications use features in this list, we recommend making changes now to avoid any future incompatibility.

• The type for field InvoiceLineItem.payableItem will be changed PayableItem! to PayableItem
• The type for field PaymentLineItem.payableItem will be changed PayableItem! to PayableItem

2024-02-15

• The limit argument used in various queries to limit the number of items returned will be changed from PositiveInt to PaginationLimit. This will set a maximum value of 2,000 for limit.
• Various objects will be renamed:
  • FindEventContactsInput will be renamed to FindContactsInput.
  • EventOffice will be renamed to Office.
  • EventTextMessagingService will be renamed to TextMessagingService.
  • EventEmailMessagingService will be renamed to EmailMessagingService.
  • EventOnlinePaymentServices will be renamed to OnlinePaymentServices.
  • EventUserAccessRights will be renamed to UserAccessRights.
  • EventUser will be renamed to EventsAirUser.
  • EventInvoiceConfiguration will be renamed to InvoiceConfiguration.
• The input type FindEventContactsInput used in the query Event.contacts will be replaced with ContactSearchFilterInput offering richer ways to filter contacts. This will also remove related types EventContactsWhere, EventContactsOrderBy and EventContactOrderByField.
• The offset argument used in Event.contacts will need to be a multiple of the limit argument, or an error will occur.
• The type used for Contact.website will be changed from URL to String to cater for instances where the field in EventsAir is not a well-formed URL. This will also be changed for input types used in contact mutations: CreateContactInput.website and UpdateContactDetailsInput.website will be changed from URL to String.