# 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**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rute.gitbook.io/carrier/applicant.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
