> For the complete documentation index, see [llms.txt](https://rute.gitbook.io/carrier/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rute.gitbook.io/carrier/applicant.md).

# Applicant

Drivers created as applicants follow a pre-onboarding flow. These drivers appear in the Applicant list and must be invited by email if the Invite toggle is enabled. Agreements must be accepted during creation. Once invited, their modal becomes locked for editing.

**Image Placeholder:**\
`![DriverApplicantModal](../assets/driver-applicant-modal.png)`\
\&#xNAN;*Figure: Add and Edit Applicant modal with invite, agreements, and locked fields after invite.*

#### Add Applicant Modal

<table><thead><tr><th width="200">Field</th><th width="110" align="center">Required</th><th>Behavior</th></tr></thead><tbody><tr><td>First/Last Name</td><td align="center">✅</td><td>Basic identity of the applicant</td></tr><tr><td>Phone Number</td><td align="center">✅</td><td>Primary contact number</td></tr><tr><td>Email</td><td align="center">Conditional</td><td>Required only if Invite toggle is active</td></tr><tr><td>Owner Type</td><td align="center">✅</td><td>Defines if the applicant is Sole Prop or Company</td></tr><tr><td>Payroll Type</td><td align="center">✅</td><td>Always set to Commission (auto-selected and locked based on Owner Type)</td></tr><tr><td>Invite Toggle</td><td align="center">Optional</td><td>Triggers system to send invitation email</td></tr><tr><td>Agreement Checkboxes</td><td align="center">✅</td><td>All agreements must be checked before saving</td></tr></tbody></table>

#### Edit Applicant Modal

<table><thead><tr><th width="230">Section</th><th>Behavior</th></tr></thead><tbody><tr><td>Invite Status</td><td>Shown with timestamp and cooldown if recently sent</td></tr><tr><td>Resend Invitation</td><td>Button shown if invite sent; disabled if under 24-hour cooldown</td></tr><tr><td>Email</td><td>Read-only once invite is sent</td></tr><tr><td>Owner Type &#x26; Agreements</td><td>Read-only once invite is sent</td></tr><tr><td>Deactivate</td><td>Button available at all times</td></tr></tbody></table>

#### Invite Logic

* Invitations are only sent if the Invite toggle is active and a valid email is entered.
* Once invited, user status becomes "Invited" and appears in the Applicant list.
* Resending invitation is allowed after 24 hours and resets the status timestamp.
* Invitations expire after 7 days if not accepted.

#### Status Flow

* Created with Invite → **Invited**
* No Invite → Remains as **Applicant**
* After Activation → Moves to **Active** list
* Manual Deactivation → Moves to **Inactive**
