> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heystandard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inviting residents

> How a resident connects the app to their record on your schedule

Each resident connects the app to their record once, using a single-use **link code**. After that, their published schedule appears automatically and stays up to date.

## How a resident joins

<Steps>
  <Step title="They receive a link code">
    Each resident gets their own 8-character code by email. The code is tied to that one person's record, so it shouldn't be shared.
  </Step>

  <Step title="They download Puffin">
    The invite email links to [Puffin on the App Store](https://apps.apple.com/us/app/puffin-physician-calendar/id6785436659). Android is coming soon.
  </Step>

  <Step title="They sign in">
    In the app, a resident signs in with **Apple** or with a **one-time code sent to their email**. No password to manage.
  </Step>

  <Step title="They enter the link code">
    On the link screen, the resident types in the code. This connects the app to their record on your schedule.
  </Step>

  <Step title="Their schedule appears">
    Once linked, the resident's calendar fills in right away from your published schedule. They don't have to wait for you to republish. From then on, republishing keeps it up to date.
  </Step>
</Steps>

<Note>
  Link codes are issued by the Standard Form team, not from the dashboard yet. To get your residents onto the app, [contact us](/contact-us/contact) and we'll send their invites. Make sure each resident is [on the schedule with an email](/puffin-for-residents/set-up-for-the-app) first, and that the schedule is published and enabled in the app.
</Note>

## A code only works once

A link code is good for a single resident, one time. Once it's been used, entering it again reports that the account is already linked. If a resident needs a fresh code, for a new phone or a wrong account, [contact us](/contact-us/contact) for a replacement.

## If linking doesn't work

* **"Could not link"**: the code was mistyped or isn't valid. Codes use digits and uppercase letters only (no `I`, `L`, `O`, or `U`), so check for look-alike characters.
* **Already linked**: that code has been redeemed. The resident is likely already connected, and can pull to refresh their calendar.
* **Signed in but no schedule**: the account is linked, but the schedule isn't published yet or isn't enabled in the app. See [Set up your schedule for the app](/puffin-for-residents/set-up-for-the-app).