Skip to main content

Participants and member records

These resources hold member accounts and their participation in events. They live under https://core.mlhtools.com/resources/ (e.g. /users, /participations).

Users​

A user is a member account. Open a user at https://core.mlhtools.com/resources/users.

Editable fields

  • First name / Last name: the member's name.
  • Claimed: whether the account has been claimed by the member.
  • Internal: whether this is an internal MLH account.

Shown (read-only): Primary email and Primary phone number.

Linked records (tabs on the user): profile, emails, phone numbers, addresses, school enrollments, employments, challenge submissions, social profiles, Discord roles, entitlements, suspensions, and promo codes.

:::info Maintainer note Clarify what Claimed and Internal mean operationally and when staff would change them, and what "impersonate" is used for. :::

Participations​

A participation records a user's involvement in a specific event. Open at https://core.mlhtools.com/resources/participations.

  • Status: one of applied, rejected, accepted, registered, checked in, or canceled.
  • Source: how the participation was created — ohq, manual import, csvifier, flatfile, avo upload, or csv upload. (Most participations arrive via imports.)
  • Registered at / Checked in at: the participation timestamps.
  • Email: the email associated with the participation.
  • Custom fields: additional participation data.

:::info Maintainer note Explain when staff edit a participation's Status by hand vs. letting an import set it, and what each status means downstream (e.g. does checked in gate swag or scoring?). :::

User profiles​

A user profile holds a member's extended details:

  • Birthdate, Gender, Race or ethnicity, Pronouns.
  • Clothing sizes and Custom fields (stored as JSON).
  • Dietary preferences.

Addresses​

Addresses are used for shipping (and, for events, venues). Fields:

  • Nickname, and contact first/last name, email, phone number.
  • Line 1–3, City, State, Postal code, Country.
  • Residential and Supports weekend deliveries flags.

A user address additionally has an address type (e.g. Shipping). The general address type can be Venue, Shipping, or Loading Dock.

Phone numbers​

  • Phone number (the identifier), Claimed, and Primary.

Social profiles​

  • Network, Network ID, and Network username for a member's linked social accounts.