Skip to main content

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.

Neo integrates with ScalePad so agents can read client and asset data, manage Lifecycle Manager content (notes, meetings, goals, deliverables), work with ControlMap compliance, and create quotes — all from inside the workflows you build.
ScalePad uses a single API key per MSP — there’s no per-end-client tenant URL. Configure it once and every workflow with ScalePad permissions can use it.
1

Get your API key from ScalePad

  1. Log in to your ScalePad account.
  2. Go to SettingsAPI Keys.
  3. Generate a new key with the scopes you need (Core, Lifecycle Manager, ControlMap, Quoter).
  4. Copy the key — it’s a UUID.
Grant the scopes broadly in ScalePad — Neo’s per-agent permission groups gate access further on the Neo side, so you can tighten there without re-issuing keys.
2

Add the integration in Neo

  1. In the Neo Dashboard, open Integrations.
  2. Find the ScalePad section.
  3. Paste your API key and save.
Neo immediately tests the key by listing one client from ScalePad Core. Save fails if the key is invalid or doesn’t reach the API.
3

Configure agent permissions

ScalePad access is opt-in per agent. Enable what each agent needs under Agent SettingsIntegrationsScalePad.

The four modules

ScalePad’s API is organized into four modules. Neo’s permission groups match this organization one-to-one.
ModuleWhat lives there
CoreClients and hardware assets (workstations, servers, network devices, mobile) synced into ScalePad from your PSA
Lifecycle ManagerNotes (ProseMirror JSON), meetings, goals, initiatives, meeting types, deliverable PDFs
ControlMapCompliance health metrics, evidences, risks, reports
QuoterQuotes, quote templates, line items, catalog (categories, item groups, item options)

Permission groups

Each module is a permission group with Disabled / Read Only / Read-Write access levels. Core is Read Only by API design — ScalePad’s Core endpoints don’t accept writes.
Permission GroupAccess LevelsWhat writing does
CoreDisabled, Read OnlyNo writes (Core is read-only at the API level)
Lifecycle ManagerDisabled, Read Only, Read/WriteCreate and update notes, meetings, goals, initiatives. Delete is opt-in.
ControlMapDisabled, Read Only, Read/WriteCreate evidences, update risks. Writes always require technician approval — even with auto mode on. Delete is opt-in.
QuoterDisabled, Read Only, Read/WriteManage quotes, templates, line items, and catalog. Delete is opt-in.
ControlMap writes always require approval — compliance evidence and risk changes are high-impact, so the agent always pauses for a technician regardless of your other settings.

Access profiles

Quick-start profiles set all four groups at once:

Read Only

All 4 modules read-only. The agent can look up anything but cannot make changes.

Operations Manager

Lifecycle Manager + Quoter read/write (autonomous). Core + ControlMap read-only.

Full Access

Lifecycle Manager + Quoter + ControlMap read/write with deletes enabled. Core stays read-only. ControlMap writes still require approval.

Safety controls

  • Core is read-only. No matter what profile you pick, Core never writes — this matches the ScalePad API design.
  • ControlMap writes are always approval-gated. Compliance changes pause for a technician regardless of agent auto-mode.
  • Delete is opt-in. Each writable permission group has a separate “Allow Delete” toggle — Read/Write doesn’t grant delete by default.
  • Path traversal blocked. Tool input is validated — URL paths containing .. are rejected to prevent permission bypass.

How agents call ScalePad

When any ScalePad permission group is non-disabled, Neo auto-injects the ScalePad API tool into the agent’s toolbox — no extra setup needed. The agent constructs requests against https://api.scalepad.com, for example:
  • GET core/v1/clients → list clients (Core, read)
  • POST lifecycle-manager/v1/notes → create a note (Lifecycle Manager, write)
  • POST controlmap/v1/clients/{id}/reports → list reports (ControlMap — POST but treated as read because the endpoint is registered as a query-POST)
The tool runs at Standard credit tier.

Security

  • API keys are stored in Azure Key Vault, never in plaintext.
  • All ScalePad traffic is HTTPS to https://api.scalepad.com.
  • Agent write access is opt-in per module.
  • Compliance (ControlMap) writes are always behind technician approval.