Skip to main content
Use Simplesat through Corsair: one client, typed API calls. Create an API key at app.simplesat.io under Settings, then API keys. Give it the scopes the operations you call need, and pass it as the plugin’s key option or store it on the account; the plugin sends it as the X-Simplesat-Token header. Things to know before you write:
  • A bad key is a 403, not a 401. Simplesat answers 403 Invalid Token. for a missing or unrecognised token on every route, and a valid key that lacks the route’s scope gets the same 403. Check the key and its scopes. The plugin treats both as auth failures.
  • Customer writes are upserts. customers.create and teamMembers.create match an existing record on external_id or email rather than always inserting, so send one of them. The schema rejects a customer with neither, because Simplesat then has nothing to match against.
  • A bulk write is queued. customers.bulk answers a request_id and a message, not the stored records, and the work happens afterwards.
  • Surveys are identified by token. surveys.email takes the survey_token from surveys.list, not the numeric survey id.
  • Sending a survey notifies a real person. surveys.email schedules an email, so it is a write.
  • Search and paging. answers.search and responses.search are POSTs because they take a filter list and date range, but their pages come back as next links that are followed with a GET. Every list answers { next, previous, count, results }, and next is a path you pass back unchanged.
  • A next link is checked before it is used. Simplesat returns a full URL, and the plugin keeps only same-host paths, so the token never travels to another host.
  • A response create can update. responses.create creates a response or updates the one that already matches it, and created backdates it, which is how a survey answered elsewhere is imported.
What you get:
  • 17 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Search responses for one customer
Upsert a customer by external id
See the full list on the API page.

What’s next

API reference

Every simplesat.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.