---
title: Client Portal Module
description: The Client Portal Module allows programs to send assessments to clients via email or text for secure remote completion. This article outlines how to set up, configure, and use the Client Portal to send and receive assessments.
---

[Skip to content](https://employeekb.persimmony.com/support/client-portal-module#main-content)

English

Show submenu for translations

![Screenshot 2025-02-20 104356.png\]](https://employeekb.persimmony.com/hs-fs/hubfs/Screenshot%202025-02-20%20104356.png?height=40&name=Screenshot%202025-02-20%20104356.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- www.persimmony.com

 www.persimmony.com

 What do you need help with?

- There are no suggestions because the search field is empty.

1. [Knowledge Base](https://employeekb.persimmony.com/support?hsLang=en)
2. [ECM](https://employeekb.persimmony.com/support/ecm?hsLang=en)
3. [Setup](https://employeekb.persimmony.com/support/ecm?hsLang=en#setup)

# Client Portal Module

## The Client Portal Module allows programs to send assessments to clients via email or text for secure remote completion. This article outlines how to set up, configure, and use the Client Portal to send and receive assessments.

#### **Requesting Client Portal Activation**

Only site administrators who manage the Persimmony contract may request activation. To request activation, contact Persimmony Support and include:

- The **contact name** to display in outgoing text messages
- A **subject line** for Client Portal email notifications
- Custom **message text** for both email and text messages

> **Tip:** These settings apply site-wide across all programs using the Client Portal.

---

#### **Granting Access via Security Settings**

To allow users to send assessments through the Client Portal:

- Go to **Security \> User Group**
- Use the **User Group** dropdown to select a group
- In the **Client List Permissions** section, check the **Client Portal** box
- Repeat for each group that needs access

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771747/original/GIeVpWw6roXWjJ72jBAt6TeVGMd9dke72Q.png?1767375235)

---

#### **Configuring Assessments for Portal Use**

 

- Go to **Setup \> Assessments**
- Select the assessment to configure
- Confirm all **Answer Types** are valid:
  
    - Check Box
    - Combo
    - Date
    - Memo
    - Number
    - Text
    - Spacer
- Under **Required Fields**:
  
    - Set **Form Field** to Grid, Home Visit, or Dental
    - Enter **Age Min / Max** values
- Click **Programs** and assign the correct program(s)

 

[![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771434/original/2ALx19QWRJgWbVcagA49drkx7f4MRWDw_g.png?1767375113)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771434/original/2ALx19QWRJgWbVcagA49drkx7f4MRWDw_g.png?1767375113)

 

- In **Optional Fields**, check the **Portal** box

 

[![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771436/original/t5xUCz2aAsLmhKl_gFjwih524YBPDT7kaw.png?1767375113)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771436/original/t5xUCz2aAsLmhKl_gFjwih524YBPDT7kaw.png?1767375113)

 

> **Tip:** Once enabled for Portal, the assessment is locked. To make changes, uncheck the Portal box, make your edits, and re-enable.

---

#### **Setting Up Program Values**

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771430/original/9bzaCGzAs93V4cPlA0D2CtjAydoBulB-sg.png?1767375113)

- Go to **Setup \> Program Values**
- Select the appropriate program
- Under **Demographics**, choose **Activity Group**, then click **New Value**
  
    - Enter a name and click **Add**
- Under **Demographics**, choose **Activity Type**, then click **New Value**

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771423/original/ZxDCofCwt4Y4cRds1bi5MorawghcJ4IAgg.png?1767375113)

- Enter a name and click **Add**

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771426/original/qGcfs8drF1yVVRMKpVcDZFBJxu9zDZZ83A.png?1767375113)

- Set **Assessment/Memo** to **Assessment**
- Click **Assm** and select all assessments that should appear under this Activity Type
- Use the **Group** dropdown to assign an Activity Group

 

[![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771422/original/KYZT6Ry4_zZ4Hm6RLFFB3cemwaBskZcxsQ.png?1767375112)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771422/original/KYZT6Ry4_zZ4Hm6RLFFB3cemwaBskZcxsQ.png?1767375112)

 

> **Repeat this setup for each program using the Client Portal.**

---

#### **Sending Assessments to Clients**

- Open a **Client Profile**
- Click **New Activity**
- Select the correct **Activity Group** and **Activity Type**
- Click **Send to Client**

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771432/original/EMkJxYGX6NCbSPaamRPLOxybKb_GCgNIxw.png?1767375113)

- In the **Send Assessment to Client** window:
  
    - Choose **Email** or **Text Message**
    - Edit **Subject**, **Expiration Time**, or **Message** if needed
    - Click **Send**
- Confirm by clicking **Yes**

A memo will be added to the Activity List showing the name of the assessment sent.

---

#### **Receiving Completed Assessments**

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771435/original/tv_f9Z_jN8ZaG0gZkS7oGs_JiWLwKCnZ9g.png?1767375113)

- From the **Client List**, click **Client Messages**

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771431/original/XSlI-ylJNK54p123tZIGufGiiWeDmrMTFg.png?1767375113)

- Locate the returned assessment
- Choose one of the following:
  
    - **Preview** to view the content
    - **Accept** to add the assessment to the client’s Activity List
    - **Delete** to remove it

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/72179771433/original/YgqykOH4YUIxWBgGYXW68ez7xAOXguQNJw.png?1767375113)

- [ECM](https://employeekb.persimmony.com/support/ecm?hsLang=en#main-content)

    - [Assessments](https://employeekb.persimmony.com/support/ecm?hsLang=en#assessments)
    - [Activity List](https://employeekb.persimmony.com/support/ecm?hsLang=en#activity-list)
    - [Clients/Signature](https://employeekb.persimmony.com/support/ecm?hsLang=en#clients-signature)
    - [Setup](https://employeekb.persimmony.com/support/ecm?hsLang=en#setup)

[![Chill listening crop-3](https://employeekb.persimmony.com/hs-fs/hubfs/Screenshot%202025-02-20%20104356.png?width=80&height=24&name=Screenshot%202025-02-20%20104356.png "Chill listening crop-3")](http://persimmony.com?hsLang=en)

Persimmony Customer Knowledge Base

Copyright © 2026, Persimmony International, Inc.