Skip to main content
Use Simplero through Corsair: one client, typed API calls. Create an API key in Simplero under Settings, then Integrations. Pass it as the plugin’s key option or store it on the account; the plugin sends it as the X-API-Key header. Simplero documents 1134 routes across every part of the platform. This plugin wraps a working set around contacts and what they buy: contacts, email lists, tags, products, purchases and subscriptions. Pages, courses, funnels, automations and the rest are not wrapped. Things to know before you write:
  • Contact creates need both required fields. Simplero requires email and lead_score on a contact, so a create must send a score. Sending a score replaces it.
  • adjustLeadScore is not update. The action adds amount (negative to subtract) to the stored score and records it, with an optional explanation, in the contact’s history; customers.update replaces the score outright.
  • Tag actions take one or many. customers.addTag and customers.removeTag accept tag_id or tag_ids, never both and never neither; the schema rejects either mistake. Tag changes can start or stop the automations attached to that tag.
  • PATCH changes only what it sends. An omitted field keeps its stored value, unlike a PUT. purchases.update and subscriptions.update are limited to buyer details and tracking data.
  • Subscription state is an action, not a field. subscriptions.update cannot subscribe or unsubscribe anyone; that is subscriptions.unsubscribe and subscriptions.resubscribe, and unsubscribing is reversible.
  • Money movements are not wrapped. Refunding, cancelling, capturing and changing a purchase price are separate Simplero actions that move funds, so they are deliberately left out.
  • Paging. page counts from 1 and per_page is 1 to 100, defaulting to 20. after is the cursor form: pass pagination.next_after and total and total_pages come back null, because counting is skipped.
  • Errors. A 401 is { "error": "Bad API key" }; a 422 is { "errors": ["…"] }, which the plugin joins into one message. A 503 can mean the idempotency store could not be checked, in which case nothing ran.
What you get:
  • 27 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

List contacts on a list
Tag a contact
See the full list on the API page.

What’s next

API reference

Every simplero.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.