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

> Make a Simplesat API key and save it in Neo

You connect Simplesat once at the MSP level, with one API key for your Simplesat account.

## 1. Make the API key

In Simplesat, open **Settings** → **API keys** and create a key named Neo. Give it the scopes your agents and dashboards need:

| Scope | Needed for |
| - | - |
| read surveys | Connecting (Neo checks the key with it), and picking a survey to send |
| read responses, read answers | Dashboards and questions about your feedback |
| write surveys | Sending a survey by email |
| read customers, write customers | Reading and updating customers |
| read team members, write team members | Reading and updating team members |
| write responses, write answers | Recording or changing responses |
| read questions | Reading a survey's questions |

Copy the key. Keep it out of email and chat: anyone who has it can read your customers' feedback.

Neo calls Simplesat at `https://api.simplesat.io` with the key in the `X-Simplesat-Token` header.

## 2. Add the key in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the Simplesat card, under Customer Success.

**2. Save the key**

Paste the API key and click **Save settings**. Neo checks it against Simplesat before saving, so a wrong key, or one without the read surveys scope, is rejected straight away.

## 3. Turn Simplesat on per agent

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

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Surveys & Questions** | Disabled, Read Only | Survey setup; no personal data. |
| **Survey Emails** | Disabled, Read / Write | Sends a survey to the customer. |
| **Responses & Answers** | Disabled, Read Only, Read / Write | Holds each customer's ratings, comments, email, company and IP address. |
| **Customers** | Disabled, Read Only, Read / Write | Your customer contacts. |
| **Team Members** | Disabled, Read Only, Read / Write | Your technicians. |

A dashboard takes its own read access to the groups it needs; you set none on an agent for it.

See [Simplesat API](https://docs.neoagent.io/agents/tools/sales/simplesat-api.md) for the profiles and what the agent can read and send.


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