Skip to content
Developers

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.

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 useAddressAuthenticate with
REST APIhttps://api.bizisy.com/v1/<module>/<action>An API key
MCP for AI appshttps://<company>.bizisy.com/mcp/manage and /mcp/meSigning in (OAuth) or an API key
MCP with a keyhttps://api.bizisy.com/mcp/manage and /mcp/meAn API key
OpenAPIhttps://api.bizisy.com/v1/openapi.jsonNothing (it describes the API)
WebhooksYour HTTPS endpointSigned 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#

  1. Make your first call: an API key, one curl, a result.
  2. Read how dry runs, errors and idempotency keys work: every integration needs them.
  3. 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.

Developer docs