---
title: "Create Contact Renewal Reminder"
method: POST
path: "/contact_renewal_reminders"
tags: ["Contact Renewal Reminders"]
---

# Create Contact Renewal Reminder

`POST /contact_renewal_reminders`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/contact_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/contact_renewal_reminders/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new ContactRenewalReminder

## Request body

- object
  - `contact_id` integer, required: The ID of the `Contact` this Renewal Reminder is for.
  - `contact_renewal_type_id` integer, required: The ID of the `Contact Renewal Type` this Renewal Reminder is for.
  - `active` boolean: Whether or not this Renewal Reminder is active.
  - `next_due_at` string, date, required: The date at which this Renewal Reminder is due. We recommend using [ISO-8601](/docs/overview/date-formatting) formatted dates to avoid ambiguity.
  - `due_soon_at` string, date: The date at which this Renewal Reminder is 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

## Response `201`

OK

- ContactRenewalReminderCreated, nullable: A Contact 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.
  - `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
  - `account_id` integer: The ID of the `Account` that this Renewal Reminder belongs to.
  - `contact_id` integer, required
  - `contact_renewal_type_id` integer, required
  - `contact_archived_at` string, date-time, nullable, required: The date and time at which this Renewal Reminder's `Contact` was archived.
  - `is_sample` boolean: Whether or not this belongs to sample data.
  - `comments_count` integer, nullable: The number of `Comments` associated with this record.
  - `watchers_count` integer: The number of watchers associated with this 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
- `403`: Insufficient permission to perform this operation
- `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)