---
title: "Create Repair Order Notification Policy"
method: POST
path: "/repair_order_notification_policies"
tags: ["Repair Order Notification Policies"]
---

# Create Repair Order Notification Policy

`POST /repair_order_notification_policies`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/repair_order_notification_policies`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/repair_order_notification_policies/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new Repair Order Notification Policy on a Payment Profile belonging to your account.

In the Fleetio UI, this top-level configuration may be labeled as a "subscription".
In this API, the top-level resource is a Repair Order Notification Policy.

## Request body

- RepairOrderNotificationPolicyCreateParameters
  - `payment_profile_id` integer, required
  - `all_vehicles` boolean
  - `name` string, nullable
  - `notification_frequency_in_minutes` 10 | 20 | 30 | 60 | 240 | 720 | 1440, nullable
  - `group_ids` Id[]: Sets the full set of Groups on the new policy. Provide the complete set of desired Group ids. Use an empty array only when creating an all-vehicles policy. If `all_vehicles` is `false`, the policy must still have at least one Group.
  - `subscriptions` object[]: Subscription recipients to create for this policy.
    - `contact_id` integer, required
    - `email` boolean
    - `text_message` boolean
    - `text_message_phone_type` string, nullable

## Response `201`

OK

- RepairOrderNotificationPolicy, nullable: A full representation of a Repair Order Notification Policy. In the Fleetio UI, the overall configuration may be labeled as a "subscription". In this API, this schema represents the top-level policy configuration. Nested `subscriptions` are recipient-level records. Each one represents one recipient and that recipient's notification settings for this policy.
  - `id` integer
  - `name` string, nullable
  - `payment_profile_id` integer
  - `all_vehicles` boolean
  - `notification_frequency_in_minutes` integer, nullable: Notification frequency in minutes. A null value indicates the policy is using the default notification schedule.
  - `groups` object[]
    - `id` integer
    - `name` string
    - `ancestry` string, nullable
    - `ancestry_names` string, nullable
  - `subscriptions` object[]: Recipient-level notification records for this policy. Each item represents one subscribed recipient and that recipient's notification settings.
    - `id` integer
    - `contact_id` integer, nullable
    - `user_id` integer
    - `email` boolean
    - `text_message` boolean
    - `text_message_phone_type` string, nullable
    - `text_message_opted_out` boolean
    - `user` object
      - `id` integer
      - `email` string, nullable
      - `full_name` string, nullable

## Other responses

- `400`: The format or parameters of the request was invalid
- `401`: Request could not be authenticated
- `403`: Insufficient permission to perform this operation
- `404`: The requested resource could not be located
- `422`: Unprocessable Entity
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 4 breaking
  - added `#/components/schemas/Id` to the `payment_profile_id` request property `allOf` list
  - added `#/components/schemas/Id` to the `subscriptions/items/contact_id` request property `allOf` list
  - the `payment_profile_id` request property type changed from `integer` to no type
  - the `subscriptions/items/contact_id` request property type changed from `integer` to no type
- **2026-06-16** `4098a1c81821`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/repair_order_notification_policies/post.md)

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)