> ## 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 Pia to Neo

> Create a Pia API app and save its secret in Neo

You connect Pia once at the MSP level, with the address of your Pia portal and the secret of a Pia API app.

## 1. Create an API app in Pia

<Steps>
  <Step title="Open Manage API Apps">
    Sign in to your Pia portal as an administrator, open **Users**, and click **Manage API Apps**.
  </Step>

  <Step title="Create the app">
    Click **New App** and name it "Neo". Pia's audit logs show this name for every action Neo takes.
  </Step>

  <Step title="Pick the scopes">
    Pick the scopes for what you want agents to do:

    | To | Scopes |
    | - | - |
    | Find automations | `TechAssist.Read`, `SmartForms.Read` |
    | Run automations and follow each run | `Packages.Execute`, `Packages.MonitorExecution` |
    | Clients and tags, delegated consent | `Clients.Read`, `Clients.Write` |
    | Pia agents | `Agents.Read`, `Agents.Write` |
    | Extension automations | `Extensions.Read`, `Extensions.Write` |
    | Connected services | `Integrations.Read` |
    | Automation source | `PiaSource.ReadWrite` |

    You can change the scopes later on the same screen. A call whose scope the app lacks is refused, and the agent tells the technician which one.
  </Step>

  <Step title="Copy the App Secret">
    Save the app and copy the **App Secret**. Pia shows it once; regenerate it if you lose it.
  </Step>
</Steps>

## 2. Add Pia in Neo

<Steps>
  <Step title="Open Integrations">
    Open [**Integrations → Pia**](https://dashboard.neoagent.io/integrations?tab=directory\&open=pia) in the Neo Dashboard. The card is under Other.
  </Step>

  <Step title="Save the connection">
    Enter the **Tenant URL**, the address you open your Pia portal at (for example `https://yourcompany.pia.ai`), paste the **App Secret** and click **Save**. Neo checks the secret with Pia before it saves, so a wrong secret is rejected straight away.
  </Step>
</Steps>

## 3. Turn Pia on per agent

Open the agent from [**Agents**](https://dashboard.neoagent.io/agents), go to the Integrations section, and configure the Pia block. To run automations on tickets, set **Automations** to Read / Write; the Helpdesk profile asks a technician before each run, and IT Admin runs them on its own.

The agent reads the ticket and writes the result through your PSA, so its PSA ticket permissions stay on.

See [Pia API](/agents/tools/management/pia-api) for what each profile does.


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