HyphaBase

What's available

The parts of a service business we've already built. Take what you need, ignore the rest.

Sarah needs her customers and her crews in the system before anything else. A clinic down the road starts the same way — the people first, then whatever else the business needs as it comes online.

Everything is a module, and each one is switched on per site. You take what you need.

The list

ModuleWhat it's forGuideReference
CustomersWho they are, where they live, what they like, whether they're still activeGuideClients
StaffWho works where, availability, time offGuideEmployees
ServicesWhat you sell, what it costs, how it's groupedGuideServices
SchedulingRecurring plans and the appointments they generateGuideSchedules
Sites and rolesSite details, users and permissions inside a siteGuideOrganizations

More modules are on the way

Bookings, invoicing, services, products and more are built and being hardened with early customers now. Each one appears here — guide and API reference together — the day it goes live, so anything you can read about is something you can call.

Where the paths are

Business endpoints all sit under /api/modules/{module}:

/api/modules/clients
/api/modules/employees/users
/api/modules/organizations/audit-logs

Not /api/clients. Two things are always needed:

Switching a module on

If a module isn't switched on for a site, its endpoints return 403 however your key is scoped. That catches people out, because it looks identical to a permissions problem.

Switch modules on from the site's row on the Locations page. You can set it per site, or across a whole group at once.

Getting 403 on a module endpoint?

Check whether the module is switched on before you start adjusting scopes. If it isn't, no scope change will help, and you can spend a long afternoon on the wrong problem.

What every module guide covers

Same shape each time, so you can skim one you've never used and know where to look:

  1. What it's for, in plain language
  2. Before you start — what needs switching on and granting
  3. What the thing looks like — the fields
  4. The endpoints — with links into the reference
  5. Creating, reading, updating, deleting — in both integration styles
  6. Whatever else hangs off it
  7. What you get told about — its webhook events
  8. What to grant — scopes
  9. What goes wrong — the failures specific to this module
  10. Recipes — real jobs, start to finish

Next

On this page