Skip to content

Person Email Form ​

Field reference for person email records. A person can have multiple email addresses of different types.

Fields ​

Backed by core.person_emails.

FieldColumnTypeRequiredNotes
Email IDperson_email_idUUIDAutoPrimary key
Personperson_idUUID (FK)YesParent person record
Email Typeemail_type_idSelect (Lookup)YesEMAIL_TYPE
Email Addressemail_addressText(255)Yes
Is Primaryis_primaryBooleanYesPrimary email for the person
Is Currentis_currentBooleanYesThe currency flag
Effective Dateeffective_dateDateNoNever populated from ODS — no source field exists
End Dateend_dateDateNoSet when the address is retired
Legacy Email IDlegacy_email_idIntegerAutoColleague/ODS source key

There is no verification or notification state: is_verified, verified_date and receives_notifications do not exist.

Contact records are end-dated, never deleted

is_current is the currency flag — there is no is_active column on any contact record. Removing a value sets is_current = false and stamps end_date; the row stays so the history survives. This holds through the admin API too. Contact values are also not unique: some 50,000 people share a phone number and 3,700 share an email, so key on the row id plus person_id, never on the value itself.

Email Type Values ​

CodeDescriptionNotes
INSTITUTIONALInstitutionalUniversity-assigned email
PERSONALPersonalPersonal email address
WORKWorkProfessional/business email

Computed Fields (Read-Only) ​

FieldDescription
DomainEmail domain (e.g., university.edu)
Is InstitutionalWhether email is from institution domain

Validation Rules ​

  1. Person must exist before adding emails
  2. Email Address must be valid email format (name@domain.ext)
  3. Only one email per type can be Is Primary = true
  4. INSTITUTIONAL email typically auto-generated from student/employee ID
  5. Institutional emails should match university domain pattern

Student Information System Documentation