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

# Connecting Autodesk to Neo

> Create an APS app, sign in once as a team administrator and save it in Neo

You connect Autodesk once at the MSP level, with your own app on the Autodesk Platform Services (APS) portal.

## Before you start

* Autodesk lets an app manage a team only for a user who is a **primary, secondary or SSO administrator** of that team. Sign in as an Autodesk account that is an administrator of every client team Neo should manage. Many MSPs use one account for this and add it as a secondary administrator in each client's team (Autodesk Account, **User Management** → **By User** → **Invite users**, then give it the administrator role).
* Neo acts as that account. Invitations and seat changes Neo makes show in Autodesk as made by it.
* Use this account for Neo alone. Autodesk keeps one sign-in per account and app, so signing the same account in to the same app anywhere else ends Neo's connection.

## 1. Create the app on the APS portal

Sign in at [aps.autodesk.com](https://aps.autodesk.com), open **My Apps**, and create an application named Neo:

* **Application type:** **Traditional Web App**. Autodesk supports no other type for this API.
* **Callback URL:** `https://localhost/callback`, exactly.
* **API Access:** turn on the **Team Admin API**.

Copy the **Client ID** and the **Client Secret**.

## 2. Sign in to the app

Open this address in the browser where you are signed in to Autodesk as the administrator account, with your Client ID in place of `<Client ID>`:

```
https://developer.api.autodesk.com/authentication/v2/authorize?response_type=code&client_id=<Client ID>&redirect_uri=https%3A%2F%2Flocalhost%2Fcallback&scope=tmadmapi%3Ateam%3Aread%20tmadmapi%3Ateam-users%3Awrite%20tmadmapi%3Ateam-products%3Awrite
```

Click **Allow**. Your browser then opens a page that does not load. That is expected: copy the whole address from the address bar. It starts with `https://localhost/callback?code=`. The code in it works once and for a few minutes, so do the next step straight away.

## 3. Save it in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the Autodesk card, under HR & Business Apps.

**2. Save the app and the sign-in**

Enter the Client ID and the Client Secret, paste the address you copied into **Sign-in**, and click **Save settings**. Neo turns the code into a token and reads the teams the account administers before saving, so a wrong secret, an expired code or an account that administers no team is rejected straight away.

**3. Check the team mapping**

Open the **Organization Mapping** tab of the Autodesk card. Neo matches each team to a company by name. Confirm a suggested match, or pick the company for a team Neo could not match.

Neo keeps the connection alive from then on. Autodesk ends a sign-in that goes unused for 15 days, and Neo renews it at least once a day, with the nightly company sync.

If you delete the app, change its Client Secret, remove the account's administrator role, or sign the account in to the same app elsewhere, Neo stops reaching Autodesk and sends you a message in the dashboard. Sign in again (step 2) and save the new address.

## 4. Turn Autodesk on per agent

Open the agent, go to the Integrations section, and pick an access profile for the Autodesk block, or set each area yourself:

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Teams** | Disabled, Read Only | The teams the account administers; a report across clients needs it. |
| **Team Users** | Disabled, Read Only, Read / Write | A team's users, and inviting a new one. |
| **Product Seats** | Disabled, Read Only, Read / Write | Product pools with seat counts, who holds each product, and assigning and freeing a seat. |

The **Helpdesk** profile asks a technician before every invitation and seat change. See [Autodesk API](https://docs.neoagent.io/agents/tools/management/autodesk-api.md) for the profiles and what the agent can read and change.


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