---
title: "Create a Service Record"
method: POST
path: "/tools/{tool_id}/services"
tags: ["Tools & Equipment > Services & Maintenance"]
---

# Create a Service Record

`POST /tools/{tool_id}/services`

Create an equipment service record

### Parameters

**cost** `OPTIONAL`

Numeric value for the cost of the service, in the currency of your account.

* * *

**date** `OPTIONAL`

Date of the service. Defaults to today

* * *

**description** `OPTIONAL`

Text description or summary of the service performed

* * *

**keywords** `OPTIONAL`

Comma delimited list of keywords, tags, or labels to allow easier searching for specific types of services.

* * *

**performed_by** `OPTIONAL`

String value for the service technician or facility that completed the work

* * *

**type** `OPTIONAL`

Type of service performed. Supported options are:

> "Air filter", "Battery fluid", "Battery - replacement", "Belts", "Brake fluid", "Brakes", "Cleaning", "Coolant", "Diesel filter", "Drivetrain", "Engine - major", "Engine oil", "Equipment service", "Fan", "Fan belt", "Fuel filter", "Fluids - other", "Hydraulic fluid", "Hydraulic pump", "Inspection", "Lubricant", "Sanitizing", "Seals", "Oil Filter", "Tire pressure", "Tires", "Transmission fluid", "Transmission - major", "Warranty", "Wheels", "Other"

* * *

**usage** `OPTIONAL`

The current amount of usage (in the `equipment usage_unit`) as of the time of the service.

## Path parameters

- `tool_id` string, required

## Headers

- `Content-Type` string

## Request body

- object

## Response `200`

Successful response

---

[API](https://skmtc.net/farmbrite/apis/farmbrite-api-developers-documentation.md) · [All operations](https://skmtc.net/farmbrite/apis/farmbrite-api-developers-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/farmbrite/farmbrite-api-developers-documentation/versions/b33a389fa2c0/schema)