> 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/administration/connecting-autodesk-construction-cloud.md).
# Connecting Autodesk Construction Cloud
Connect Autodesk Construction Cloud (ACC) so you can ask Cogram about your ACC projects, files, and issues in plain language: read-only, and always within your own Autodesk permissions.
## Why connect Autodesk Construction Cloud
Cogram is an AI platform for the architecture, engineering, and construction (AEC) industry. Connecting ACC lets you ask the Cogram [Agent](https://app.cogram.com/dashboard/agent) about your Autodesk project data in plain language, alongside your meetings, emails, and reports in Cogram, without switching to Autodesk or digging through folders.
Cogram reads live from Autodesk when you ask. Nothing is synced or stored, and every read happens as the signed-in user, so you only ever see what your own Autodesk account is already permitted to see. That keeps the integration safe to roll out across a whole organization: no shared credentials, no copied data, no new permissions to manage.
> Cogram's access is **read-only**. It reads the projects, folders, files, and metadata your Autodesk account can see. It cannot create, edit, move, or delete anything in Autodesk.
### What you can ask about
* **Projects**: the ACC projects and accounts (hubs) you can access.
* **Files and folders**: the document tree in a project, and previous versions of a file.
* **File details**: metadata and model properties for a document.
* **Issues**: issues logged on a project.
* **Downloads**: a link to open or download a specific file.
### Example prompts
* "List the projects in our Autodesk Construction Cloud account."
* "What's in the Drawings folder of the \[project name] project?"
* "Find the latest version of the curtain wall shop drawings in \[project name]."
* "Summarize the open issues on \[project name]."
* "Get me a download link for the door hardware submittal."
* "What are the model properties of \[drawing or model file]?"
Naming the project (and the folder or file, if you know it) gets you a faster, more precise answer. If the Agent can't find something, it's usually a permissions or naming difference in Autodesk: confirm your Autodesk account can see it.
## Setting up the Autodesk connection
Two one-time steps make ACC data available: a Cogram user connects their own Autodesk account, and an Autodesk admin approves Cogram once for the whole account.
> The **Connect** and **Approve** steps live on [Organization Settings → Connectors](https://app.cogram.com/dashboard/settings/admin/connectors), which is available to **Cogram organization admins**. Other users don't open this page; when they first ask the Agent for ACC data, it prompts them to connect their own Autodesk account (the same sign-in as Step 1).
### Prerequisites
* An Autodesk Construction Cloud account on a **full ACC subscription** (Custom Integrations is not available on Trial / Essentials tiers).
* For the one-time approval: an **Autodesk admin** (Hub Admin) for your account.
* In Cogram, an organization admin opens [Organization Settings → Connectors](https://app.cogram.com/dashboard/settings/admin/connectors) and selects the **Autodesk Construction Cloud** connector.
### 1. Connect your Autodesk account
> **Who:** each Cogram user, for their own account. On the Connectors page an org admin connects their own account; everyone else connects from the Agent.
1. Open [Organization Settings → Connectors](https://app.cogram.com/dashboard/settings/admin/connectors) and select the **Autodesk Construction Cloud** connector.
2. Under **Step 1 · Connect your Autodesk account**, select **Connect**.
3. Sign in to Autodesk and approve the access request.
Step 1: select Connect
Sign in to Autodesk, then select Allow
When the window closes, Step 1 shows **Connected as ``**.
{% hint style="info" %}
You can connect before your Autodesk admin has finished Step 2. Until the approval is in place, the connection succeeds but returns no project data. Complete Step 2, then verify.
{% endhint %}
Once connected, Step 2 shows the values to approve in Autodesk
### 2. Approve Cogram in your Autodesk account
> **Who:** an **Autodesk admin** (Hub Admin), once per Autodesk account.
This authorizes Cogram's application to read data the connected users can access. The **Step 2** card appears once you have completed Step 1; once approval is confirmed it collapses to a short confirmation.
1. In the **Step 2** card, copy the three values Cogram shows: **Client ID**, **App name**, and **Description** (each has a copy button).
2. Select **Open Autodesk** to open Autodesk Construction Cloud in a new tab. This lands you on your ACC home; from there, open **Hub Admin**.
3. In Autodesk, go to **Hub Admin → Custom Integrations** and select **+ Add custom integration**.
4. In the dialog, paste your copied values into the matching fields (the field names differ slightly from Cogram's):
* **Autodesk Platform Services Client ID** ← Cogram's **Client ID**
* **Custom integration name** ← Cogram's **App name**
* **Description** ← Cogram's **Description** (optional free-text; safe to skip)
5. Save the integration and make sure it is **Active**.
6. Back in Cogram, select **Verify connection**.
Once approval is confirmed, the **Not approved yet** status clears and Step 2 collapses to **Cogram is approved — you can access your ACC data**.
### Expected result
* Step 1 shows **Connected as ``**.
* Step 2 reads **Cogram is approved — you can access your ACC data** (it collapses to this one-line confirmation; the button there becomes **Re-verify**).
* Cogram can now read your ACC projects, files, and metadata on demand: ask the [Agent](https://app.cogram.com/dashboard/agent) using the [example prompts](#example-prompts) above.
## Troubleshooting
**Symptom**: **Verify connection** stays on **Not approved yet** even though you just approved the integration in Autodesk. **Likely cause**: Verify checks ACC using your connection, so it needs Step 1 completed first; or the Custom Integration was added but not set to **Active**, or the values were mistyped. **Fix**: Confirm Step 1 shows **Connected as …**, then in Autodesk confirm the Custom Integration uses the exact **Client ID** Cogram shows and is **Active**. Re-paste from the copy buttons and select **Verify connection** again.
**Symptom**: "Not approved yet" and you are on an Autodesk Trial or Essentials plan. **Likely cause**: Custom Integrations requires a full ACC subscription; the setting is unavailable on Trial / Essentials tiers. **Fix**: Upgrade to a full ACC subscription, then complete Step 2.
**Symptom**: Cogram says your Autodesk connection has expired. **Likely cause**: The stored authorization lapsed (for example, after a long period of no use). **Fix**: In **Step 1**, select **Connect** again to re-authorize.
## Disconnecting
To remove the connection, in **Step 1** select **Disconnect**. Cogram immediately loses the ability to read your ACC data until you reconnect. Disconnecting does not change anything in Autodesk.
## Next steps
* [Agent](/guides/agent.md): how to work with the Cogram Agent across all your project data, including your connected ACC data.
For support, please contact .
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.cogram.com/administration/connecting-autodesk-construction-cloud.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.