Skip to main content
Use FreeAgent through Corsair: one client, typed API calls. Connect a FreeAgent OAuth 2.0 app (client ID and secret from dev.freeagent.com). Access tokens last an hour and refresh automatically. Pass sandbox: true to use api.sandbox.freeagent.com for both OAuth and the API. This plugin exposes company profile, verified sender addresses, contacts, projects, selected invoice and recurring invoice operations, and tracking groups. Many other official company API routes remain unimplemented; see the linked route inventory in the package README. The Accountancy Practice API requires practice-enabled OAuth and X-Subdomain client scoping and is excluded. What you get:
  • 36 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
Create a contact
See the full list on the API page.

What’s next

API reference

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