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

# Applied Epic Agent Connector

> Set up your agency's Applied Epic connection, control what Agents can read and change, and use Epic in Agents, Skills, and Workflows.

The Applied Epic [Connector](https://docs.cassidyai.com/agents/connectors/overview.md) lets your
[Agents](https://docs.cassidyai.com/agents/overview.md) work with your agency management system during a
conversation. Ask an Agent to find a client, summarize their active policies,
pull a document from their attachments, or add a new client after checking for
duplicates.

Your whole agency uses one Epic connection that an admin sets up once. Nobody
signs in to Epic separately. The admin decides who can use the connection and
which actions Agents can take.

## Set up Epic for your agency

> [!NOTE]
>
> **Prerequisites**: The **Manage Connectors** privilege in Cassidy.

**1. Get a production app in Applied DevCenter**

If your agency already has a production app with the Epic APIs you need,
use its credentials and continue to the next step. Otherwise:

1. **Create an account** in [Applied DevCenter](https://devcenter.myappliedproducts.com/docs/overview).
2. **Create a mock app** under **My Workspace** → **Mock Apps**, selecting
   these API products: **Clients**, **Contacts**, **Policies** (v2),
   **Companies**, **Organizations**, **CRM Module**, **Attachments** (v2),
   and **Attachment Folders**.
3. **Request App Promoter permission.** Contact your system administrator
   or use **Contact Us** in Applied DevCenter.
4. **Request production access.** Select your mock app, click **Promote to
   Prod**, and submit the request to Applied for approval.
5. **Get your production credentials.** Once approved, find your app under
   **My Workspace** → **API Projects** and copy its **Consumer Key** and
   **Consumer Secret** for the Cassidy setup below.

> [!NOTE]
>
> Applied says production promotion requests can take **two to five business
> days**. Getting App Promoter permission can add more time, so start this
> process well before your Cassidy rollout.

**2. Open the Applied Epic Connector**

Open **Organization Settings** → **Connectors** and find **Applied Epic**.
If its status is **Disabled**, enable it from the status menu. See [Manage
Connectors for your organization](https://docs.cassidyai.com/settings/manage-connectors.md#enable-or-disable-a-connector).

**3. Enter your agency's credentials**

Choose **Set up** from the Connector's menu, then enter the Consumer Key and
Consumer Secret. Cassidy checks them with Epic before saving.

![Applied Epic in the Connectors list with its menu open and the Set up option shown](https://mintcdn.com/cassidy/L6ULzqK3F0xkn_aQ/images/integrations/applied-epic-connector-menu.png?fit=max\&auto=format\&n=L6ULzqK3F0xkn_aQ\&q=85\&s=9bbf8c1f2ed9998ebf9a81a35f6a44f7)

![Applied Epic setup dialog with Consumer Key and Consumer Secret fields](https://mintcdn.com/cassidy/L6ULzqK3F0xkn_aQ/images/integrations/applied-epic-setup-dialog.png?fit=max\&auto=format\&n=L6ULzqK3F0xkn_aQ\&q=85\&s=27e34c8788c4072a83145fc9a28c0769)

**4. Check role privileges**

Everyone whose role has the **Applied Epic** privilege can use the
connection. The **Access** section on the connector's page lists those roles.
See [See who can use a
Connector](https://docs.cassidyai.com/settings/manage-connectors.md#see-who-can-use-a-connector).

**5. Choose which actions are on**

Open **Action permissions** to turn off anything your agency shouldn't use.
See [Choose what Agents can do](#choose-what-agents-can-do) below.

## Choose what Agents can do

Epic actions are grouped into four categories:

| Category | What Agents can do | Default |
| - | - | - |
| **Read clients and policies** | Search clients, find duplicates, and read contacts, policies, lines, and benefits | **Always allow** |
| **Read documents** | Browse a client's attachments and open the files | **Always allow** |
| **Read tax IDs** | Read FEINs and similar registration numbers for business contacts | **Disabled** |
| **Create and update clients** | Add new clients and change existing client details | **Disabled** |

You control these settings at two levels:

* **For your organization** — An admin can turn actions off for everyone or
  require approval before they run. Nobody can go past these limits. See
  [Action permissions](https://docs.cassidyai.com/settings/manage-connectors.md#action-permissions).
* **For each Agent** — Whoever builds the Agent can make its settings stricter,
  for example by asking before every client update. See [Action
  approvals](https://docs.cassidyai.com/agents/connectors/overview.md#action-approvals).

When an Agent asks to create or update a client, the approval shows which
client it will change, so you can check it before you allow it.

## Add Epic to an Agent

**1. Open the Agent's Connectors**

Edit the Agent and scroll to **Connectors** in the **Setup** tab.

**2. Add Applied Epic**

Click **+ Add Connector** and add **Applied Epic**. There's no connection to
choose; the Agent uses your agency's connection.

**3. Set action permissions**

Choose **Always allow**, **Ask every time**, or **Disabled** for each
category or action.

**4. Save and publish**

Click **Save** or **Publish**.

Sharing the Agent doesn't give people Epic access. Each person who chats with
the Agent in Cassidy also needs a role with the **Applied Epic** privilege.

> [!TIP]
>
> To read attachments, turn on [Code Execution & File
> Creation](https://docs.cassidyai.com/agents/advanced/code-execution-file-creation.md) for the Agent. The
> Agent can then read scanned PDFs as well as text documents.

## Use Epic in your own chats, Skills, and Workflows

* **Your own chats** — Open **Customize** → **Connectors**, find **Applied
  Epic**, and click **Add connector**. You don't enter any credentials. Turn
  the toggle off to pause Epic in your chats, or click **Remove** to clear your
  personal settings.
* **Skills** — Add Applied Epic to a [Skill](https://docs.cassidyai.com/skills/build-and-configure.md#connectors)
  like any other Connector.
* **Workflows** — Add Applied Epic to a [Generate
  Text](https://docs.cassidyai.com/reference/actions/generate-text.md) action. You need the **Applied Epic**
  privilege to use it in a Workflow. Actions that need
  approval can't run in a Workflow, because nobody is there to approve them.

## Deploy an Agent that uses Epic

When you deploy an Agent to [Slack](https://docs.cassidyai.com/integrations/slack/deploy-agent.md),
[Microsoft Teams](https://docs.cassidyai.com/agents/deploy/microsoft-teams.md), [Google
Chat](https://docs.cassidyai.com/agents/deploy/google-chat.md), [email](https://docs.cassidyai.com/agents/deploy/email.md), or a
[website](https://docs.cassidyai.com/agents/deploy/embed.md), it uses your agency's Epic connection for
everyone who can reach it. Those people don't need the Applied Epic privilege in
Cassidy.

> [!WARNING]
>
> Before you deploy, check who can reach the deployment and turn off any Epic
> actions that audience shouldn't use. Actions that need approval can't run in a
> deployed Agent.

## Change or remove the agency setup

* **Edit credentials** replaces the Consumer Key and Consumer Secret. The
  connection stays the same. You re-enter the secret each time.
* **Delete configuration** removes the credentials, the connection, and
  everyone's personal Epic settings. Organization action
  permissions are kept. Agents can't use Epic until an admin sets it up again.

Both options are in the Connector's menu and need the **Manage Connectors**
privilege.

## Troubleshooting

> [accordion] An Agent says to ask an administrator to set up Applied Epic
>
> Nobody has set up your agency's connection yet, or it was deleted. An admin
> needs to [set up Epic](#set-up-epic-for-your-agency).

> [accordion] An Agent says you don't have access to Applied Epic
>
> Your role needs the **Applied Epic** privilege. Ask an admin to update your
> role.

> [accordion] An action says your agency's Applied app doesn't include this API
>
> Your agency's app in the Applied Developer Center is missing that part of
> the Epic API. An admin can add it there. You don't need to change anything
> in Cassidy.

> [accordion] An action says it requires a newer version of Applied Epic
>
> Some actions only work with recent Epic releases. Ask whoever manages your
> Epic system about upgrading, or turn the action off.

> [accordion] An Agent says the Applied Epic credentials are invalid
>
> The Consumer Key or Consumer Secret has changed or expired. An admin can
> replace them with [Edit credentials](#change-or-remove-the-agency-setup).

> [accordion] An Agent can't open an attachment
>
> Turn on [Code Execution & File
> Creation](https://docs.cassidyai.com/agents/advanced/code-execution-file-creation.md) for the Agent, and
> check that **Read documents** is on.

## Next steps

> [card] [Manage Connectors for your organization](https://docs.cassidyai.com/settings/manage-connectors.md)
>
> Set organization-wide action permissions and approval requirements.

> [card] [Connectors overview](https://docs.cassidyai.com/agents/connectors/overview.md)
>
> Learn how Connectors, connections, and approvals work across apps.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.