> For the complete documentation index, see [llms.txt](https://docs.cogram.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cogram.com/integrations/connecting-egnyte.md).

# Connecting Egnyte

Turn on Egnyte for your firm so Cogram files project emails, meeting minutes, RFIs, submittals and field reports into each project's Egnyte folder, and each person can search Egnyte from Cogram.

Turn on Egnyte once for your organization. Then:

* **Filing (whole firm):** Cogram files each linked project's completed items into that project's Egnyte folder. It uploads as a **Service Account**, an Egnyte user your firm creates for Cogram, so uploads show in Egnyte's audit log as that account.
* **Search (each person):** everyone connects their own Egnyte account and sees only the files they can open in Egnyte.

## Prerequisites

* You are an administrator in Cogram.
* Cogram has made Egnyte available to your organization. If you do not see Egnyte under Integrations, contact your Cogram account manager.
* Someone at your firm can add users and set folder permissions in Egnyte.

## When to use this

* Your firm keeps its project record in Egnyte.
* Project teams copy emails, minutes or RFIs into Egnyte by hand today.
* Your team wants to find Egnyte files from Cogram search and the Agent.

## Turn on Egnyte

1. Go to [Organization Settings → Integrations → Egnyte](https://app.cogram.com/dashboard/settings/admin/integrations#egnyte).
2. In **Egnyte domain**, enter your domain, for example `yourfirm` for `yourfirm.egnyte.com`.
3. Select **Turn on Egnyte**.

The Egnyte card now shows your domain and two rows:

* **Filing** (Whole firm): who Cogram files as. Until you connect the Service Account, it shows **Set up in File export**.
* **Search** (Each person): how many people have connected their own Egnyte, and a link to **Your Egnyte connection**.

To change the domain or turn Egnyte off, use the **⋯** menu on the card. Both remove the filing account and every person's Egnyte sign-in. When you turn Egnyte off, project links stay, but filing pauses.

## Set up the Service Account in Egnyte

1. In Egnyte, add a user for Cogram, for example `cogram@yourfirm.com`. Give it the **Power User** role.
2. Give that user **Editor** permission on every folder that holds project folders, for example `/Shared/Projects`.
3. Sign in to Egnyte once as that user, so the account is active and has a password.

An Administrator account also works, but it can reach more than Cogram needs. Power User with Editor permission is enough.

### Mark your project folders (recommended)

If your firm uses Egnyte **Project Folders**, mark each project's folder as a project and enter its project number, for example `29.2614`. Use the same number as the project in Cogram.

Cogram then suggests the right folder for each project, so you do not pick folders one by one.

## Connect the Service Account

Cogram files through the Service Account. You connect it in File export.

1. Open a private browser window and sign in to Egnyte as the Service Account.
2. Go to [Organization Settings → Integrations → File export](https://app.cogram.com/dashboard/settings/admin/integrations#file-export).
3. Under **Choose where to file**, in the Egnyte tile, select **Connect filing account**. Approve access in the Egnyte window that opens.
   * To sign in from the private window instead, expand **How to set up the Service Account**, select **Copy sign-in link**, and open the link there.

### What good looks like

* File export shows **Filing as** the Service Account.
* The Egnyte card's **Filing** row says that Cogram files as the service account, with its Egnyte role. Below it, a usage line shows **API calls today**, the daily limit and the calls per second.

Nothing uploads yet. Cogram files a project only after it is linked to a folder. See [File export](https://docs.cogram.com/integrations/file-export.md).

## Connect your own Egnyte account

Each person connects their own Egnyte account. Cogram then shows Egnyte as your account sees it: you see only the folders and files you can open in Egnyte. Nothing is copied into Cogram.

1. Go to [Account Settings → Integrations](https://app.cogram.com/dashboard/settings/account-settings/integrations#egnyte).
2. In the Egnyte row, select **Connect**, and sign in to Egnyte as yourself in the window that opens.

The row shows your Egnyte user and domain, and a usage line, **Your API calls today**, for your own account.

Once you are connected:

* **Search:** In ⌘K (**Ctrl+K** on Windows), type at least three characters and pause. Matching Egnyte files show in their own section. Select a file to preview it in Cogram, or open it in Egnyte. A file that Cogram filed shows once, as its Cogram record.
* **Documents:** When your firm files to Egnyte, [Documents](https://app.cogram.com/dashboard/documents) shows Egnyte beside your files in Cogram, so you can browse it without leaving Cogram. If your firm also has a file server connected, Documents shows the one new links file to.
  * A project linked to an Egnyte folder shows only that folder, marked **Project folder**.
  * A project with no folder yet says **No folder linked to this project**. People who can manage the project's file export can select **Link a folder**. Everyone else sees that a project owner can link one.
* **Filed files:** Files that Cogram filed show a **Filed from Cogram** badge. Select **Open in Cogram** to go to the item the file came from. Edits to the copy in Egnyte do not sync back to Cogram.
* **Agent:** The [Agent](https://app.cogram.com/dashboard/agent) can search and read your Egnyte files with your Egnyte permissions, and links each file it uses.

If the row says "Your organization hasn't turned on Egnyte. Ask an admin.", ask an administrator to [turn on Egnyte](#turn-on-egnyte).

## How much Cogram can do per day

Egnyte limits how many API calls each Egnyte connection makes: 10 a second and 50,000 a day. The Service Account and each person's connection have separate limits, so one person's searching does not slow filing.

* Filing runs every few minutes. New items are filed within minutes of being completed.
* Through the Service Account, Cogram files up to about 700 items an hour for your firm, over 15,000 a day. A project's past items normally finish within a day. Cogram shows an estimate before you include them.
* When a daily limit is reached, filing pauses and continues when Egnyte allows more calls. Nothing is lost. The usage line shows when the count resets.

## Troubleshooting

#### Egnyte uploads are paused

The Egnyte card says "Egnyte uploads are paused."

* **Likely cause:** Cogram can no longer sign in as the Service Account, usually because its password changed.
* **Fix:** Sign in to Egnyte as the Service Account in a private window, then select **Reconnect**. Items added in the meantime upload after you reconnect.

#### Filing account is an Administrator

The Filing row says "A Service Account with Editor permission is enough."

* **Likely cause:** You connected with an Egnyte Administrator.
* **Fix:** Nothing breaks. To limit what Cogram can reach, connect a Power User Service Account instead.

#### Egnyte window does not open

The Egnyte window does not open when you select **Connect filing account** or **Connect**.

* **Likely cause:** Your browser blocked the pop-up.
* **Fix:** Allow pop-ups for app.cogram.com, then try again. For the Service Account, you can also select **Copy sign-in link** and open the link in the private window.

#### Wrong Egnyte user

File export shows the wrong Egnyte user after **Filing as**.

* **Likely cause:** The browser was signed in to Egnyte as you, not as the Service Account.
* **Fix:** In File export, under **Choose where to file**, select **Change**, then **Sign in as another Egnyte account**. Do this from a private window signed in as the Service Account.

#### Folder missing

A project shows **Folder missing**.

* **Likely cause:** The project's folder was moved, renamed or deleted in Egnyte, or the Service Account lost access.
* **Fix:** Restore the folder or the Service Account's **Editor** permission, or link the project to its new folder.

#### Egnyte sign-in stopped

Your Egnyte row says "Egnyte stopped accepting your sign-in."

* **Likely cause:** Egnyte no longer accepts the sign-in Cogram saved for you, for example after a password change.
* **Fix:** Select **Reconnect** in [Account Settings → Integrations](https://app.cogram.com/dashboard/settings/account-settings/integrations#egnyte).

#### Daily Egnyte limit reached

Search shows "Daily Egnyte limit reached. Try again tomorrow."

* **Likely cause:** Your own Egnyte connection used all of its calls for the day.
* **Fix:** Wait for the daily count to reset. Filing is not affected.

## Things to know

* Cogram only adds files to Egnyte. It never overwrites, renames or deletes them. If a file with the same name is already in the folder, Cogram gives its own file a new name.
* Egnyte's audit log shows every upload as the Service Account.
* Cogram files each item once. Moving or renaming a file in Egnyte does not make Cogram upload it again.
* To stop filing for a while, use **Pause filing** in File export. **Disconnect from Egnyte** in File export stops filing to Egnyte, unlinks its projects and clears the filing defaults. Files already in Egnyte stay, and search still works.

## Next steps

* [File export](https://docs.cogram.com/integrations/file-export.md): choose what Cogram files, and link projects to their folders.
* [Privacy and confidentiality](https://docs.cogram.com/get-started/privacy-and-confidentiality.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cogram.com/integrations/connecting-egnyte.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
