Home Integrations Newsroom and Wonde Data Integration

Newsroom and Wonde Data Integration

View as Markdown
By melissa@teamhq.com.au· Last updated Oct 30, 2026 · Integrations

How the Integration Works

PortalHQ connects to Wonde, which reads data from the school’s management system (MIS) and makes it available through the Wonde API. PortalHQ connects using the Wonde API token and Wonde school ID set up for the school. Once a day, PortalHQ retrieves current students, their parents and carers, and staff from Wonde. Newsroom by PortalHQ then refreshes its contact lists from that data, so families and staff who join or leave flow through to mailing lists automatically, with no manual uploads required.

Audiences can be built from any of the fields listed below (for example, all parents of Year 7 boarders, or all staff in a particular position), and those lists remain current as the school’s records change.

Step Frequency What happens
Wonde to PortalHQ Daily, around 7:10pm AEST (8:10pm during daylight saving) Students are read first, then parents and carers, then staff, and each is updated in PortalHQ.
PortalHQ to Newsroom by PortalHQ contacts Daily Newsroom by PortalHQ contacts and dynamic mailing lists are refreshed from the synced records. Families and staff who have left are removed.

Current Families (Parents and Carers)

Parent and carer details are drawn from the Wonde contacts endpoint (contacts, with contact_details and students included). Each Wonde contact lists the students they are linked to, and PortalHQ uses those links to connect the parent to their children.

A parent or carer is only included when they have an email address in Wonde and are linked to at least one current student who has also been synced into PortalHQ. When a family’s last child leaves the school, that family is removed from the current parent audience automatically.

Fields retrieved for each parent or carer
PortalHQ field Source in Wonde Notes
Parent ID Contact: mis_id The MIS identifier, used to match the same person on every sync.
Title Contact: title
First name Contact: forename
Surname Contact: surname
Email address Contact details: emails, email Contacts without an email address are skipped.
Salutation Contact details: salutation
Mobile Contact details: phones, mobile
Relationship to student Linked students: relationship, relationship Taken from the first linked student that has a relationship recorded, for example Mother or Father.
Children Linked students: mis_id Only links to current students synced into PortalHQ are kept.

Wonde does not supply a deceased flag for contacts, so this cannot be screened automatically. Contacts who should no longer receive email should be unlinked from the student in the school’s MIS, or unsubscribed in Newsroom by PortalHQ.

Fields inherited from their children (for targeting)
PortalHQ field Source
Year level(s) Each current child’s year group
House(s) Each current child’s house
Form class(es) Each current child’s registration group
Boarding parent Whether any current child is a boarder

Current Students

Student details are drawn from the Wonde students endpoint (students, with contact_details, year, boarding and groups included). A student is treated as current when Wonde gives them a year group. Students without an email address in Wonde are not synced, and their parents are not linked to them in PortalHQ. Future enrolments are not brought in ahead of their start date.

PortalHQ field Source in Wonde Notes
Student ID Student: mis_id
First name Student: forename
Surname Student: surname
Email address Contact details: emails, email Required. Students without one are skipped.
Year level Year: name “Year 7” becomes 7. Names containing “Pre” become Prep, and Kindergarten and Junior Kindergarten become K and JK.
Gender Student: gender Male and Female are recorded. Other values are left blank.
Form class Groups: name of the group with type “registration”
House Groups: name of the group with type “house”
Boarder Boarding: type A student is a boarder when the type is “boarding”.

Staff

Staff details are drawn from the Wonde employees endpoint (employees, with contact_details, roles and employment_details included). Staff are only included when they have an email address. The school can also ask for staff to be limited to its own email domain, so personal addresses are left out.

PortalHQ field Source in Wonde Notes
Staff ID Employee: mis_id
Title Employee: title
First name Employee: forename
Surname Employee: surname
Email address Contact details: emails, work Falls back to the main email when no work email is recorded.
Teaching staff Employment details: teaching_staff Stored in PortalHQ, not used for Newsroom by PortalHQ targeting.
Teacher code Employment details: teacher_number
Staff number Employment details: staff_code
Position Employment details: role_text

Alumni

Alumni are not retrieved from Wonde by the automatic sync, which reads current students, families and staff only. Instead, alumni are loaded into Newsroom by PortalHQ from a spreadsheet export, and each contact is tagged as alumni with a Class Of year so that cohorts can be targeted (for example, a Class of 2016 reunion). The import can be repeated whenever the school’s alumni records are updated.

Schools that maintain alumni records in another system, such as a CRM or foundation database, can also push contacts into Newsroom by PortalHQ through the PortalHQ API.

Newsroom by PortalHQ field Spreadsheet column
First name Given name
Surname Surname
Email address Email (rows without an email are skipped)
Class Of Graduating year
Is Alumni Set automatically on import

Privacy and Preferences

  • Newsroom by PortalHQ only reads contact data from Wonde. It never writes contact details back to Wonde or the school’s MIS.
  • Contacts who unsubscribe in Newsroom by PortalHQ remain unsubscribed. A subsequent sync does not re-subscribe them.
  • Every email sent from Newsroom by PortalHQ includes an unsubscribe link.

Enquiries

For any queries regarding this integration, please contact TeamHQ at support@teamhq.com.au or +61 2 8387 7321.

Was this page helpful?