---
title: "Create Vehicle Renewal Reminder"
method: POST
path: "/vehicle_renewal_reminders"
tags: ["Vehicle Renewal Reminders"]
---

# Create Vehicle Renewal Reminder

`POST /vehicle_renewal_reminders`

## Request

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

Creates a new Vehicle Renewal Reminder

## Request body

- object
  - `vehicle_id` integer, required
  - `vehicle_renewal_type_id` integer, required
  - `next_due_at` string, date-time, required: The date and time at which this Renewal Reminder will be due next. We recommend using [ISO-8601](/docs/overview/date-formatting) formatted dates to avoid ambiguity.
  - `due_soon_at` string, date-time: The date and time at which this Renewal Reminder will be considered due soon. We recommend using [ISO-8601](/docs/overview/date-formatting) formatted dates to avoid ambiguity.
  - `due_soon_time_threshold_interval` integer: Used in conjunction with `due_soon_time_threshold_frequency`. Together they form a full due soon parameter eg; "1 week", "5 months", "10 years"
  - `due_soon_time_threshold_frequency` 'day' | 'week' | 'month' | 'year' | 'days' | 'weeks' | 'months' | 'years', nullable
  - `active` boolean: Whether this Renewal Reminder is active.
  - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields).

## Response `201`

OK

- VehicleRenewalReminderCreated, nullable: A Vehicle Renewal Reminder
  - `id` integer, required
  - `created_at` string, date-time: The date and time at which this record was created.
  - `updated_at` string, date-time: The date and time at which this record was most recently updated.
  - `account_id` integer, required
  - `vehicle_id` integer, required
  - `vehicle_renewal_type_id` integer, required
  - `vehicle_archived_at` string, date-time, nullable, required: The date and time at which this Renewal Reminder's `Vehicle` was archived, if applicable.
  - `active` boolean, nullable, required: Whether or not this Renewal Reminder is active.
  - `next_due_at` string, date-time, required: The date and time at which this Renewal Reminder is next due.
  - `last_sent_at` string, date-time, nullable, required: The date and time at which this Renewal Reminder was last sent.
  - `due_soon_at` string, date-time, nullable, required: The date and time at which this Renewal Reminder will next be marked as "Due Soon".
  - `due_soon_time_threshold_interval` integer, nullable, required: The amount of time before a Renewal is due where it will be marked as as "Due Soon".
  - `due_soon_time_threshold_frequency` 'day' | 'week' | 'month' | 'year' | 'days' | 'weeks' | 'months' | 'years', nullable, required
  - `comments_count` integer, nullable, required: The number of `Comments` on this Renewal Reminder.
  - `custom_fields` object, required
  - `is_sample` boolean: Whether this Renewal Reminder is sample data.
  - `watchers_count` integer: The count of watchers associated with the record.
  - `watchable_options` object: Options related to watching the record.
  - `bulk_watch_record` boolean: Indicates if a bulk watch record is created.
  - `skip_automatic_watchers_callbacks` boolean: Indicates if automatic watchers callbacks are skipped.

## Other responses

- `401`: Request could not be authenticated
- `422`: Unprocessable Entity
- `500`: Something unexpected happened

---

[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)