iSAMS: what to do when data is not being imported

NOTE: In addition to the information below, please note that there will be a delay between you changing the data in iSAMS (also known as IRIS Ed:Gen) and those changes being available to sync with Tes Parents' Meetings via the iSAMS API. The length of this delay depends on what you have set as the value for the API Key Cache Expiry. We recommend that you set it to 1 hour, rather than the default 24 hours.


If students are not being brought across, please ensure that they have: 

  1. A class which has an assigned teacher.
  2. A date of birth
  3. A year group (eg Year 6)


If a parent is not being brought across, please ensure that:

  1. The contact shows in the iSAMS API. Depending on your API key's settings, the contact types shown may differ. This can be edited at a later date in the API key's methods.
  2. They have a title (eg Mr, Mrs, Dr), forename and surname. Full stops are removed from the title during the iSAMS sync.
  3. Either:
    • If the parent lives with the student, enable the "Student Home" option. This is indicated by a star icon next to the account in iSAMS. 

      As long as there is something in the parent's "RelationshipRaw" field, they will be pulled through regardless of their type of relationship. 

    • In cases where the parent doesn't live with the student, disable the "Student Home" option. 

      Parents will only be pulled through if their "RelationshipRaw" field starts "Mother", "Father", "Guardian" or "Step". This is so we match relationships like "Stepfather".

  4. (Optional) If you wish to pull in the email addresses for the contacts, please ensure that the email address field has been filled in on the parent's record.

It's also worth checking the settings in your parents' evening system. If a parent is missing and they're set up within iSAMS as 'contact only', you'll need to ensure the box highlighted below is ticked in your settings. If it's not, you can tick this, save, resync, and it should fix the issue


If the teacher is not being brought across, please ensure they have:

  1. A title (eg Mr,Mrs,Dr), forename and surname. Full stops are removed from the title during the iSAMS sync.
  2. At least one class assigned.
  3. (Optional) An email address - which will be used as the email of their record on SchoolCloud.


We check for different kinds of classes in the iSAMS API and currently bring across the following (as long as they have assigned teachers):

  • Sets
  • Forms
  • Year Heads
  • House Heads
  • Boarding House Heads
  • Teaching Forms (both the Form Assistant and Secondary Assistant, if one is set, are brought across)
  • Personal Tutors


We check for the following groups in the iSAMS API. These groups just contain students and will only appear as part of the student filter when creating an evening or event:

  • House Groups
  • Boarding House Groups
  • Division Groups
  • Custom Pupil Group