---
title: "Create Bonus Rule"
method: POST
path: "/api/field/bonus-rules"
tags: ["field"]
---

# Create Bonus Rule

`POST /api/field/bonus-rules`

## Request

- Base URL: `https://api.electricair.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.electricair.io/api/field/bonus-rules`
- Auth: none declared

## Request body

- BonusRuleRequest
  - `name` string, required
  - `basis` string, required
  - `amount` number, required
  - `categories` string[]
  - `business_units` string[]
  - `roles` string[]
  - `split` string
  - `max_visit_days` integer, nullable
  - `forfeit_on_callback_days` integer, nullable
  - `active` boolean

## Response `200`

OK

- BonusRuleSchema
  - `id` integer, required
  - `name` string, required
  - `basis` string, required
  - `amount` number, required
  - `categories` string[], required
  - `business_units` string[], required
  - `roles` string[], required
  - `split` string, required
  - `max_visit_days` integer, nullable
  - `forfeit_on_callback_days` integer, nullable
  - `active` boolean, required

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-10-28** `558d42db3b2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/changes/api/field/bonus-rules/post.md)

---

[API](https://skmtc.dev/electricair/apis/electric-air-autoquote-api.md) - [All operations](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/llms.txt) - [OpenAPI document](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/revisions/a13d832a5676?raw)
