> ## Documentation Index
> Fetch the complete documentation index at: https://speckle-assistant.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Autodesk Construction Cloud

> Connect and sync your Autodesk Construction Cloud models with Speckle for analytics, dashboards, and automation workflows.

<Info>
  The Autodesk Construction Cloud integration is available only on **Enterprise** workspaces.\
  To enable it for your organisation, <a href="mailto:office@speckle.systems?subject=Autodesk%20Construction%20Cloud%20Integration%20enquiry">get a quote</a>.
</Info>

## Setup

<Steps>
  <Step title="Add a custom integration to ACC">
    <Info>
      You’ll need **Account Admin** access to add the Speckle Integration to ACC.
    </Info>

    1. Go to your Account Admin page at [acc.autodesk.com](http://acc.autodesk.com/) or [acc.autodesk.eu](http://acc.autodesk.eu/)
    2. Select **Custom Integrations** under the Account Admin panel
    3. Select **Add custom integrations**
    4. Enter the integration details:

           <Frame>
             <img src="https://mintcdn.com/speckle-assistant/EtTDRKNK-G5ONjnd/images/beta/integrations/acc-add%20custom%20integration.png?fit=max&auto=format&n=EtTDRKNK-G5ONjnd&q=85&s=44d464e8eca683ace4391609059bfc7c" alt="Add custom integration" width="1620" height="1080" data-path="images/beta/integrations/acc-add custom integration.png" />
           </Frame>

       * **Client ID**: `5Y2LzxsL3usaD1xAMyElBY8mcN6XKyfHfulZDV3up0jfhN5Y`
       * **Name**: `Speckle`
    5. Select **Next**.
    6. Select **Proceed Anyway** from the permission warning.

           <Frame>
             <img src="https://mintcdn.com/speckle-assistant/EtTDRKNK-G5ONjnd/images/beta/integrations/acc-premission%20warning.png?fit=max&auto=format&n=EtTDRKNK-G5ONjnd&q=85&s=3aec2ab847a70f739908e4d8a1c50498" alt="Permission warning" width="1620" height="579" data-path="images/beta/integrations/acc-premission warning.png" />
           </Frame>
  </Step>

  <Step title="Sign in to Autodesk Construction Cloud">
    1. Select **workspace settings** from the workspace dropdown (top left).

           <Frame>
             <img src="https://mintcdn.com/speckle-assistant/EtTDRKNK-G5ONjnd/images/beta/integrations/acc-workspace%20settings.png?fit=max&auto=format&n=EtTDRKNK-G5ONjnd&q=85&s=b52133d386ae8b18430e15f8c1d6334f" alt="Workspace settings" width="1620" height="1080" data-path="images/beta/integrations/acc-workspace settings.png" />
           </Frame>
    2. Select **Log in** next to Autodesk Construction Cloud.

           <Frame>
             <img src="https://mintcdn.com/speckle-assistant/EtTDRKNK-G5ONjnd/images/beta/integrations/acc-login.png?fit=max&auto=format&n=EtTDRKNK-G5ONjnd&q=85&s=db482529f4944deec9ef45a92659d498" alt="Login" width="1780" height="1240" data-path="images/beta/integrations/acc-login.png" />
           </Frame>
    3. Sign in to your ACC account and select **Allow** from the authorization dialog.

           <Frame>
             <img src="https://mintcdn.com/speckle-assistant/EtTDRKNK-G5ONjnd/images/beta/integrations/acc-authorize%20app.png?fit=max&auto=format&n=EtTDRKNK-G5ONjnd&q=85&s=4261103724d4f62db5df119932ecf335" alt="Authorize app" width="1780" height="1240" data-path="images/beta/integrations/acc-authorize app.png" />
           </Frame>

    Your integration is now set up.
  </Step>

  <Step title="Sync your first model">
    1. From your project in Speckle, select **Add model > Sync from ACC**.

           <Frame>
             <img src="https://mintcdn.com/speckle-assistant/EtTDRKNK-G5ONjnd/images/beta/integrations/acc-add%20model.png?fit=max&auto=format&n=EtTDRKNK-G5ONjnd&q=85&s=fd379f787ce522158f5b8f9678aaee44" alt="Add model" width="1780" height="1240" data-path="images/beta/integrations/acc-add model.png" />
           </Frame>
    2. Select the file you want to sync. Your hubs, projects, folders and files from ACC will be listed here.
           <Frame>
             <img src="https://mintcdn.com/speckle-assistant/EtTDRKNK-G5ONjnd/images/beta/integrations/acc-select%20file.png?fit=max&auto=format&n=EtTDRKNK-G5ONjnd&q=85&s=94d7914493a8c101fd1bc5e55639252e" alt="Select file" width="1780" height="1240" data-path="images/beta/integrations/acc-select file.png" />
           </Frame>
    3. *Optionally*, define the view to export. See [View Selection](#view-selection) below for details on how this affects what gets synced.

    <Frame>
      <img src="https://mintcdn.com/speckle-assistant/EtTDRKNK-G5ONjnd/images/beta/integrations/acc-confirm%20selection.png?fit=max&auto=format&n=EtTDRKNK-G5ONjnd&q=85&s=14d3df6843d3edc5b67ba09d8d94fbb7" alt="Confirm selection" width="1780" height="1240" data-path="images/beta/integrations/acc-confirm selection.png" />
    </Frame>

    4. Select **Create**.

    This connects your ACC file to your Speckle model. Changes in ACC sync automatically to Speckle.
  </Step>
</Steps>

## Supported File Formats

The following file formats are currently supported for syncing from Autodesk Construction Cloud:

| Format | Extension | Status      |
| ------ | --------- | ----------- |
| Revit  | `.rvt`    | ✅ Supported |
| IFC    | `.ifc`    | ✅ Supported |

<Info>
  We're planning to add support for additional formats like `.dwg` and `.nwd` (Navisworks) in future releases.
</Info>

## View Selection

When syncing a Revit file from ACC, you can optionally specify a view name to control which elements are included in the sync.

### No view specified (default)

When you don't specify a view name, **all supported elements from the entire model are synced**. This includes every element across all model.

This is the recommended option when you want:

* A complete representation of your model
* Access to all elements for analytics and dashboards
* Maximum data availability for downstream workflows

### Specifying a view name

When you enter a specific view name, **only elements visible in that view are synced**. The view name must match exactly (case-sensitive) with a view in your Revit model.

This is useful when you want to:

* Sync only a portion of your model
* Focus on specific areas or disciplines
* Match the scope of a particular coordination view
* Sync views that correspond to different design options

<Warning>
  If the specified view name doesn't exist in the model, the sync will fail. Make sure the view name matches exactly.
</Warning>

<AccordionGroup>
  <Accordion title="Is the connection read-only?">
    Yes. Speckle establishes a read-only connection with Autodesk Construction Cloud, which means we can sync and analyze your data but can't modify the original files. This ensures data integrity and security.
  </Accordion>

  <Accordion title="How often do files sync?">
    Once you've created a sync model, it automatically syncs whenever a new version of the file is published to Autodesk Construction Cloud. You don't need to manually trigger ongoing synchronization.
  </Accordion>

  <Accordion title="What if my sync fails?">
    Common causes include file access issues, authorization problems, or unsupported file formats. Check that:

    * The file is accessible
    * Your permissions are correct
    * The file is in **.rvt** or **.ifc** format

    Contact support if issues persist.
  </Accordion>

  <Accordion title="How do I get access?">
    Contact us at [hello@speckle.systems](mailto:hello@speckle.systems) to request access.
  </Accordion>

  <Accordion title="What's the difference between the ACC integration and other integrations?">
    The ACC integration provides direct integration with Autodesk Construction Cloud and enables automatic synchronization of construction data. Unlike other integrations that require manual file uploads or connectors, ACC syncs happen automatically when files are updated in the cloud.
  </Accordion>

  <Accordion title="Can I use Autodesk Construction Cloud models with Speckle Intelligence?">
    Yes. Once synced, your Autodesk Construction Cloud models can be used with Speckle Intelligence for analytics, dashboard creation, and generating insights from your construction data.
  </Accordion>
</AccordionGroup>

## Roadmap

| Feature                                  | Status         |
| ---------------------------------------- | -------------- |
| ACC account connection and authorization | ✅ Complete     |
| Revit (`.rvt`) file synchronization      | ✅ Complete     |
| IFC (`.ifc`) file synchronization        | ✅ Complete     |
| Automatic sync on file updates           | ✅ Complete     |
| Basic sync status monitoring             | ✅ Complete     |
| Enhanced UI/UX for sync management       | ✅ Complete     |
| Advanced sync configuration options      | 🔄 In Progress |
| Improved error handling and reporting    | 🔄 In Progress |

## Getting Help

For questions or to request access, contact our support team or visit the [Speckle Community](https://speckle.community/).
