Developers
Connect your own software and AI assistants to ServFlo with the REST API, the MCP server and webhooks.
Everything you can do in the ServFlo app, you can do through the API. The app, the technician app, Flo and the MCP server all call the same API, with the same permissions and the same activity log, so there is no "app-only" feature you have to work around.
You have three ways in:
- REST API. JSON over HTTPS at
https://app.servflo.ai/api. Use it from your own code, a spreadsheet script, Zapier-style tools or anything that can send a web request. - MCP server. Connect Claude, ChatGPT, Cursor or another AI assistant so it can work in
ServFlo for you, at
https://app.servflo.ai/api/mcp. - Webhooks. ServFlo sends signed events (a job completed, an invoice paid) to your URL as they happen.
Quick start
Create an API key
In ServFlo, open Settings → Developers and click Create API key. Pick an access level,
create the key and copy it. It starts with sfk_ and is shown only once. See
Authentication.
Find your business's id
Almost every path starts with /organizations/{organizationId}, where organizationId is your
business's id. A key works only in the business it was made in.
The id isn't shown on a ServFlo screen yet. The quickest way to get it: in Settings →
Developers, under Webhooks, click Add endpoint with any https address you can read (a
request-inspector URL works), then click Send test event and open the delivery's
Request. The event body's organizationId is your id. Every record the API returns carries it
too.
Check it, and see what your key may do, with Your role and permissions:
curl "https://app.servflo.ai/api/organizations/$ORGANIZATION_ID/permissions" \
-H "Authorization: Bearer $SERVFLO_API_KEY"Make your first call
List your customers:
curl "https://app.servflo.ai/api/organizations/$ORGANIZATION_ID/customers?limit=5" \
-H "Authorization: Bearer $SERVFLO_API_KEY"The answer has items and a total. See Pagination.
Who can use it
- The API, the MCP server and webhooks are on the Pro plan. On other plans, calls with a key
answer
402 PLAN_UPGRADE_REQUIRED. - Owners and admins create and revoke API keys and webhooks.
- A key acts as the person who made it. It never does more than that person's role allows today: if their role changes or they leave, the key follows.
Authentication
API keys, access levels, expiry and connected apps.
API reference
Every endpoint, with parameters, fields and curl examples.
Connect an AI assistant
Use ServFlo from Claude, ChatGPT or Cursor over MCP.
Webhooks
Get signed events when things happen in ServFlo.
Errors
Status codes and what to do about each one.
Conventions
Money in cents, dates in your time zone, retries and ids.