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.