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

# Onboarding

This guide walks through the initial setup process that new users complete when accessing Peach for the first time.

Most users complete setup in less than 5 minutes.

***

## Before you begin

Peach relies on your institution's email environment to authenticate users and connect shared mailboxes.

Before starting setup, confirm that your IT team has completed the Microsoft 365 integration process.

Your IT team should have:

* Configured Peach in Microsoft Entra
* Granted the required Microsoft permissions
* Assigned users or security groups to the Peach application
* Granted access to the shared mailbox your office uses for student communications

<Info>
  Most setup issues occur when the Microsoft integration has not been completed or the user does not have access to the appropriate shared mailbox.
</Info>

[View the Microsoft 365 setup guide](/overview)

<Note>
  Once your IT team has completed these steps, you can continue with onboarding.
</Note>

***

## What you'll accomplish

By the end of setup, you will:

* Sign in using your institutional account
* Connect your team's shared inbox
* Upload institutional policies and procedures
* Invite team members
* Prepare Peach to draft policy-aligned responses

***

## Step 1: Sign in

Authenticate using your institutional Microsoft 365 account.

Peach uses your organization's existing authentication system and does not require a separate password.

<img src="https://mintcdn.com/peach-a7014530/-3BmNAM5sexueeOs/images/Screenshot-2026-06-22-at-4.14.12-PM.png?fit=max&auto=format&n=-3BmNAM5sexueeOs&q=85&s=a2b2da3e60e1fb2af1c8e31785ddca43" alt="Screenshot 2026 06 22 At 4 14 12 PM" width="1744" height="1300" data-path="images/Screenshot-2026-06-22-at-4.14.12-PM.png" />

<Note>
  Once authentication is complete, Peach will identify the shared mailboxes you have access to.
</Note>

***

## Step 2: Connect your shared inbox

Depending on how your institution was set up, you may not see this step during onboarding.

<Frame>
  <img src="https://mintcdn.com/peach-a7014530/SsRTEYXEYiUbwsW5/images/Screenshot-2026-06-22-at-5.27.52-PM-2.png?fit=max&auto=format&n=SsRTEYXEYiUbwsW5&q=85&s=ae75e9ca5e15b60e2300ad27d3be6ac9" alt="Screenshot 2026 06 22 At 5 27 52 PM 2" width="1400" height="1030" data-path="images/Screenshot-2026-06-22-at-5.27.52-PM-2.png" />
</Frame>

The shared inbox selection screen is only shown when Peach does not yet have a shared inbox connected for your institution.

If another user has already configured Peach, such as:

* An IT administrator testing the Microsoft integration
* Another administrator completing setup
* A staff member who previously connected an inbox

then Peach may skip this step and continue directly to the next stage of onboarding.

<Info>
  Even if you do not see this step during onboarding, you can connect additional shared inboxes at any time from **Settings → Email Integration**.

  See the [Connect a Shared Inbox](/getting-started/connect-a-shared-inbox) guide for detailed instructions.
</Info>

If displayed, select the shared mailbox your office uses to communicate with students.

Common examples include:

* [financialaid@college.edu](mailto:financialaid@college.edu)
* [finaid@college.edu](mailto:finaid@college.edu)
* [scholarships@college.edu](mailto:scholarships@college.edu)

Begin typing the mailbox name and select the appropriate inbox.

<img src="https://mintcdn.com/peach-a7014530/SsRTEYXEYiUbwsW5/images/Screenshot-2026-06-22-at-5.28.07-PM-1.png?fit=max&auto=format&n=SsRTEYXEYiUbwsW5&q=85&s=f23b1b23294490e03cdf3bb5d24147e0" alt="Screenshot 2026 06 22 At 5 28 07 PM 1" width="1408" height="1056" data-path="images/Screenshot-2026-06-22-at-5.28.07-PM-1.png" />

<Warning>
  If your shared mailbox does not appear, contact your Microsoft administrator to verify mailbox permissions.
</Warning>

***

## Step 3: Upload policies and procedures

Upload the documents Peach should use when generating drafts and answering questions.

Examples include:

* Financial aid policies
* Verification procedures
* Scholarship guidelines
* Appeal processes
* Internal office documentation

<img src="https://mintcdn.com/peach-a7014530/-3BmNAM5sexueeOs/images/Screenshot-2026-06-22-at-5.30.04-PM.png?fit=max&auto=format&n=-3BmNAM5sexueeOs&q=85&s=bdbb99cb5a7becc1481678089861a43b" alt="Screenshot 2026 06 22 At 5 30 04 PM" width="1506" height="1104" data-path="images/Screenshot-2026-06-22-at-5.30.04-PM.png" />

Supported file types:

* PDF (.pdf)
* Microsoft Word (.docx)
* Text files (.txt)

<Info>
  Peach uses these documents to generate institution-specific responses rather than generic financial aid guidance.
</Info>

<Note>
  You can skip this step and upload documents later to the Knowledge Base.
</Note>

***

## Step 4: Invite your team

Once your inbox is connected, invite other staff members who should have access to Peach.

Navigate to:

```text theme={null}
Settings → Team Management
```

Administrators can add users individually or grant access through Microsoft security groups.

Each user can be assigned one of the following roles:

### Admin

Admins can:

* Manage users
* Configure integrations
* Connect shared inboxes
* Manage platform settings

### Editor

Editors can:

* Work on tickets
* Generate AI-assisted drafts
* Send emails
* Access connected inboxes

<Info>
  Only users who have been assigned access to the Peach application by your institution's IT team can sign in.
</Info>

<Note>
  We recommend inviting all staff members who regularly respond to student inquiries from your shared mailbox.
</Note>

***

## What happens next?

<Steps>
  <Step title="Your inbox begins syncing">
    Incoming student emails are imported into Peach.
  </Step>

  <Step title="Documents are indexed">
    Uploaded materials become available to the AI Assistant and email drafting workflows.
  </Step>

  <Step title="Your team can collaborate">
    Staff members can access Peach and work on tickets together.
  </Step>

  <Step title="Student inquiries are resolved faster">
    Generate drafts, reference institutional policies, and send responses directly from Peach.
  </Step>
</Steps>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Tickets" icon="ticket" href="/platform/tickets">
    Learn how to manage incoming student inquiries.
  </Card>

  <Card title="Knowledge base" icon="book-open" href="/platform/knowledge-base">
    Learn how Peach uses institutional policies and procedures.
  </Card>
</CardGroup>
