Service types API

REST endpoints for service types in ServFlo: 4 operations with parameters, request and response fields, permissions and curl examples.

Base URL: https://app.servflo.ai/api. Every call needs Authorization: Bearer sfk_… (Authentication); {organizationId} ($ORGANIZATION_ID in the examples) is your business's id.

Operation	Endpoint	Risk
List service types	`GET /organizations/{organizationId}/service-types`	`read`
Create a service type	`POST /organizations/{organizationId}/service-types`	`write`
Update a service type	`PATCH /organizations/{organizationId}/service-types/{serviceTypeId}`	`write`
Delete a service type	`DELETE /organizations/{organizationId}/service-types/{serviceTypeId}`	`sensitive`

List service types

GET /organizations/{organizationId}/service-types

The kinds of work the business does, with default duration (minutes), default price (cents) and colour. Seeded with six on first read. Read-only.


Permission	`catalog.read` (Owner, Admin, Dispatcher, Technician, Member)
Risk	`read`, OAuth scope `servflo.read`. Read: reads only.
MCP tool	`serviceTypes_list` (toolset `pricebook`, in the default set)

Example

curl "https://app.servflo.ai/api/organizations/$ORGANIZATION_ID/service-types" \
  -H "Authorization: Bearer $SERVFLO_API_KEY"

Response

200: the answer's fields

An array of objects:

Field	Type	Description
`id`	string	Service type id.
`organizationId`	string
`name`	string
`description`	string or null
`defaultDuration`	integer	Default job length in minutes.
`defaultPriceCents`	integer	Default job price, in integer cents.
`color`	string
`onlineBookable`	boolean	Offered on the public booking form.
`serviceIntervalDays`	integer or null
`defaultBusinessUnitId`	string or null
`weatherSensitive`	boolean	Outdoor work that plans around the weather.
`weatherMaxRainChance`	integer or null	Rain chance limit (%); null = 50.
`weatherMaxWindMph`	integer or null	Wind limit (mph); null = 25.
`weatherMinTempF`	integer or null
`weatherMaxTempF`	integer or null
`createdAt`	string (date-time)
`updatedAt`	string (date-time)

Create a service type

POST /organizations/{organizationId}/service-types

Adds a service type. A duration of 0 becomes 60 minutes. Returns it.


Permission	`catalog.write` (Owner, Admin)
Risk	`write`, OAuth scope `servflo.write`. Write: creates or changes records inside the business; nothing leaves it.
MCP tool	`serviceTypes_create` (toolset `pricebook`)

Request body

Field	Type	Required	Description
`name`	string	Yes
`description`	string or null	No
`defaultDuration`	integer	No	-100000–100000.
`defaultPriceCents`	integer	No	Money in integer cents (12500 = 125.00). -100000000–100000000.
`color`	string	No
`onlineBookable`	boolean	No	Offered on the public booking form and widgets (default true).
`serviceIntervalDays`	integer or null	No	How often this service is usually repeated, in days (e.g. 180 for twice a year); used by the "service due" prediction. Null: no usual interval. 1–3650.
`defaultBusinessUnitId`	string or null	No	The business unit its jobs, requests and quotes default to (GET /business-units); null = none. An inactive or non-bookable unit takes it off the online booking form. Up to 100 characters.
`weatherSensitive`	boolean	No	Outdoor work that plans around the weather: its jobs show the forecast and the office is alerted when it turns bad (Pro). Omitted on create: set from the name and the trade (e.g. Gutter cleaning).
`weatherMaxRainChance`	integer or null	No	A visit is BAD at or above this chance of rain (%); null = 50. 0–100.
`weatherMaxWindMph`	integer or null	No	BAD at or above this wind in mph (gusts count at 75 %); null = 25. 1–150.
`weatherMinTempF`	integer or null	No	BAD below this temperature (°F); null = no limit. -60–130.
`weatherMaxTempF`	integer or null	No	BAD above this temperature (°F); null = no limit. -60–140.

Example

curl -X POST "https://app.servflo.ai/api/organizations/$ORGANIZATION_ID/service-types" \
  -H "Authorization: Bearer $SERVFLO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Dana Whitfield"}'

Response

201: the answer's fields

Field	Type	Description
`id`	string	Service type id.
`organizationId`	string
`name`	string
`description`	string or null
`defaultDuration`	integer	Default job length in minutes.
`defaultPriceCents`	integer	Default job price, in integer cents.
`color`	string
`onlineBookable`	boolean	Offered on the public booking form.
`serviceIntervalDays`	integer or null
`defaultBusinessUnitId`	string or null
`weatherSensitive`	boolean	Outdoor work that plans around the weather.
`weatherMaxRainChance`	integer or null	Rain chance limit (%); null = 50.
`weatherMaxWindMph`	integer or null	Wind limit (mph); null = 25.
`weatherMinTempF`	integer or null
`weatherMaxTempF`	integer or null
`createdAt`	string (date-time)
`updatedAt`	string (date-time)

Update a service type

PATCH /organizations/{organizationId}/service-types/{serviceTypeId}

Changes the fields sent. Existing jobs keep their own price and duration. Returns it.


Permission	`catalog.write` (Owner, Admin)
Risk	`write`, OAuth scope `servflo.write`. Write: creates or changes records inside the business; nothing leaves it.
MCP tool	`serviceTypes_update` (toolset `pricebook`)

Parameters

Name	In	Type	Required	Description
`serviceTypeId`	path	string	Yes

Request body

Field	Type	Required	Description
`name`	string	No
`description`	string or null	No
`defaultDuration`	integer	No	-100000–100000.
`defaultPriceCents`	integer	No	Money in integer cents (12500 = 125.00). -100000000–100000000.
`color`	string	No
`onlineBookable`	boolean	No	Offered on the public booking form and widgets (default true).
`serviceIntervalDays`	integer or null	No	How often this service is usually repeated, in days (e.g. 180 for twice a year); used by the "service due" prediction. Null: no usual interval. 1–3650.
`defaultBusinessUnitId`	string or null	No	The business unit its jobs, requests and quotes default to (GET /business-units); null = none. An inactive or non-bookable unit takes it off the online booking form. Up to 100 characters.
`weatherSensitive`	boolean	No	Outdoor work that plans around the weather: its jobs show the forecast and the office is alerted when it turns bad (Pro). Omitted on create: set from the name and the trade (e.g. Gutter cleaning).
`weatherMaxRainChance`	integer or null	No	A visit is BAD at or above this chance of rain (%); null = 50. 0–100.
`weatherMaxWindMph`	integer or null	No	BAD at or above this wind in mph (gusts count at 75 %); null = 25. 1–150.
`weatherMinTempF`	integer or null	No	BAD below this temperature (°F); null = no limit. -60–130.
`weatherMaxTempF`	integer or null	No	BAD above this temperature (°F); null = no limit. -60–140.

Example

curl -X PATCH "https://app.servflo.ai/api/organizations/$ORGANIZATION_ID/service-types/{serviceTypeId}" \
  -H "Authorization: Bearer $SERVFLO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Dana Whitfield","description":"string","defaultDuration":1}'

Response

200: the answer's fields

Field	Type	Description
`id`	string	Service type id.
`organizationId`	string
`name`	string
`description`	string or null
`defaultDuration`	integer	Default job length in minutes.
`defaultPriceCents`	integer	Default job price, in integer cents.
`color`	string
`onlineBookable`	boolean	Offered on the public booking form.
`serviceIntervalDays`	integer or null
`defaultBusinessUnitId`	string or null
`weatherSensitive`	boolean	Outdoor work that plans around the weather.
`weatherMaxRainChance`	integer or null	Rain chance limit (%); null = 50.
`weatherMaxWindMph`	integer or null	Wind limit (mph); null = 25.
`weatherMinTempF`	integer or null
`weatherMaxTempF`	integer or null
`createdAt`	string (date-time)
`updatedAt`	string (date-time)

Delete a service type

DELETE /organizations/{organizationId}/service-types/{serviceTypeId}

Destructive: deletes the service type; jobs and requests that used it keep their data without it.


Permission	`catalog.write` (Owner, Admin)
Risk	`sensitive`, OAuth scope `servflo.sensitive`. Sensitive: moves money, deletes, sends or shows something to a customer, or grants or revokes access.
MCP tool	`serviceTypes_delete` (toolset `pricebook`)
Approval	Over MCP, this tool always waits for your approval in ServFlo. See Approvals.

Parameters

Name	In	Type	Required	Description
`serviceTypeId`	path	string	Yes

Example

curl -X DELETE "https://app.servflo.ai/api/organizations/$ORGANIZATION_ID/service-types/{serviceTypeId}" \
  -H "Authorization: Bearer $SERVFLO_API_KEY"

Response

200: the answer's fields

Field	Type	Description
`ok`	true

On this page