Getting started
Bizisy developer docs
On this page
Every action in Bizisy is one HTTPS call. The web app, the REST API and the MCP servers that AI assistants use all run the same action definitions, so anything you can do in the product you can do here, with the same permissions, the same checks and the same record in Activity.
- Your first callAn API key, one curl command, a result. Two minutes.
- API referenceAll 1196 actions, their inputs, outputs and examples.
- MCP and AIConnect Claude, ChatGPT, Cursor and others; tools and skills.
- Webhooks85 event types, signed, retried for a day.
- GuidesImport a company, hire end to end, sync people, export data.
- ConceptsDry runs, idempotency, errors, visibility, approvals.
What you can build#
- Connect your other systems. Keep payroll, IT accounts, a badge system or a data warehouse in step with your people: read the directory and job history, and get a webhook the moment someone is hired, changes job or leaves.
- Set up a company in one call. Load locations, teams and people from another tool with
org.setup.apply, previewing every change first. - Give HR an AI assistant. Connect Claude, ChatGPT, Cursor or any MCP client to the HR Assistant: it works with the person's own permissions, previews each change and records it in Activity, so HR decides and the assistant does the busywork.
- Build an app for every company. Build a Bizisy app that companies install from the app directory, with a free developer account; test it in your own company, and build it with an AI assistant through the developer MCP server.
- Automate the routine. Start onboarding checklists, send invites, export people for an audit or answer a GDPR access request from a script.
How it fits together#
| You use | Address | Authenticate with |
|---|---|---|
| REST API | https://api.bizisy.com/v1/<module>/<action> | An API key |
| MCP for AI apps | https://<company>.bizisy.com/mcp/manage and /mcp/me | Signing in (OAuth) or an API key |
| MCP with a key | https://api.bizisy.com/mcp/manage and /mcp/me | An API key |
| OpenAPI | https://api.bizisy.com/v1/openapi.json | Nothing (it describes the API) |
| Webhooks | Your HTTPS endpoint | Signed by Bizisy |
The API has 1196 actions today. Each one has the same name everywhere: org.people.hire is POST https://api.bizisy.com/v1/org/people.hire and the MCP tool org_people_hire.
Start here#
- Make your first call: an API key, one
curl, a result. - Read how dry runs, errors and idempotency keys work: every integration needs them.
- Find the actions you need in the API reference, or follow a guide.
Questions, or something here doesn't match what the API does? Write to hello@bizisy.com with the X-Request-Id of the call.
Something missing or wrong on this page? Write to hello@bizisy.com.