> ## 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 Phin Security to Neo

> Enable the Phin API in the Phin Portal and save its Client ID, Client Secret and your Partner ID in Neo

You connect Phin once at the MSP level. One Phin API client covers every company under your partner.

## 1. Enable the Phin API

**1. Open the Phin API integration**

Sign in to the Phin Portal at portal.phinsec.io. At the **Partner** level, open **Integrations** and choose **Phin API**.

**2. Enable it and copy the values**

Enable the API. Copy the **Client ID**, the **Client Secret** and your **Partner ID**. Phin shows the Client Secret only once: store it only in Neo. If you lose it, rotate the secret on the same page and save the new one in Neo.

## 2. Add the values in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the Phin Security card, under Security Awareness Training.

**2. Save the values**

Paste the **Client ID**, the **Client Secret** and the **Partner ID** into their own fields and click **Save settings**. Neo checks them against Phin's test route before saving, so a wrong value is rejected straight away.

Neo then maps your Phin companies to your PSA companies. Check the **Organization Mapping** tab on the card, and confirm or correct each suggested match.

## 3. Turn Phin on per agent

Open the agent, go to its **Tools & Settings** tab, click **Security Awareness Training**, and expand the **Phin Security** block. Pick a preset, or set each area yourself:

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Companies** | Disabled, Read Only, Read/Write | Your Phin companies. Write creates a company. |
| **Users** | Disabled, Read Only, Read/Write | Users with their status, department and manager. Write imports, edits, sleeps and deletes users. Users from an Azure or Google sync change only in that sync. |
| **Campaigns and Results** | Disabled, Read Only | Active campaigns, each user's phishing and training results for 12 months, and the list of reports. |
| **Company Admins** | Disabled, Read/Write | Add a company admin, who gets a password setup email from Phin. |
| **Billing Usage** | Disabled, Read Only | Billable and enrolled users for your partner and each company. |

| Preset | What runs on its own | What asks a technician |
| - | - | - |
| **Read Only** | Every read | Nothing: Neo changes nothing in Phin |
| **Helpdesk** | Every read | Every write |
| **IT Admin** | Reads, and user imports, edits, sleeps and deletes | A new company or company admin |
| **Full Automation** | Everything | Nothing |

See [Phin Security API](https://docs.neoagent.io/agents/tools/security/phin-api.md) for what the agent can do.


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