Create Vehicle Renewal Reminder
Creates a new Vehicle Renewal Reminder
- application/json
Request Body
- vehicle_id integer required
Possible values:
>= 1
- vehicle_renewal_type_id integer required
Possible values:
>= 1
- next_due_at date-time required
The date and time at which this Renewal Reminder will be due next. We recommend using ISO-8601 formatted dates to avoid ambiguity.
- due_soon_at date-time
The date and time at which this Renewal Reminder will be considered due soon. We recommend using ISO-8601 formatted dates to avoid ambiguity.
- due_soon_time_threshold_interval integer
Possible values:
>= 1
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 string
Possible values: [
day
,week
,month
,year
,days
,weeks
,months
,years
] - active boolean
Whether this Renewal Reminder is active.
- custom_fields object
*Full details on working with Custom Fields here.
- 201
- 401
- 422
- 500
OK
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
- id integer
Possible values:
>= 1
- created_at date-time
The date and time at which this record was created.
- updated_at date-time
The date and time at which this record was most recently updated.
- active boolean
Whether or not this Renewal Reminder is active.
- next_due_at date-time
The date and time at which this Renewal Reminder is next due.
- last_sent_at date-time
The date and time at which this Renewal Reminder was last sent.
- due_soon_at date-time
The date and time at which this Renewal Reminder will next be marked as "Due Soon".
- due_soon_time_threshold_interval integer
Possible values:
>= 1
The amount of time before a Renewal is due where it will be marked as as "Due Soon".
- due_soon_time_threshold_frequency string
Possible values: [
day
,week
,month
,year
,days
,weeks
,months
,years
] - account_id integer
Possible values:
>= 1
- vehicle_id integer
Possible values:
>= 1
- vehicle_renewal_type_id integer
Possible values:
>= 1
- vehicle_archived_at date-time
The date and time at which this Renewal Reminder's
Vehicle
was archived, if applicable. comments object[]
id integerPossible values:
>= 1
created_at date-timeThe date and time at which this record was created.
updated_at date-timeThe date and time at which this record was most recently updated.
commentable_type CommentableTypePossible values: [
Contact
,FleetcorCard
,FuelEntry
,InventoryJournalEntry
,Issue
,Part
,PurchaseOrder
,ServiceEntry
,ServiceReminder
,SubmittedInspectionItem
,Vehicle
,VehicleAssignment
,Vendor
,WexCard
,WorkOrder
]The type of record that the Comment will be left on. Must be associated with a matching
commentable_id
.commentable_id integerPossible values:
>= 1
user_id integerPossible values:
>= 1
title string deprecatedThe title of the Comment.
comment stringThe content of the Comment message body.
user_full_name stringThe full name of the
User
who created the Comment.user_image_url stringThe image url for the
User
who created the Comment.rich_content objecthtml_content stringThe comment message body rendered as HTML.
with_mentions booleanIndicates if the message body contains @mentions.
- comments_count integer
The number of
Comments
on this Renewal Reminder. - custom_fields object
- is_sample boolean
Whether this Renewal Reminder is sample data.
- watchers_count int32
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.
- is_watched boolean
Indicates whether the record is being watched.
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"active": true,
"next_due_at": "2023-03-14T13:46:27-06:00",
"last_sent_at": "2023-03-14T13:46:27-06:00",
"due_soon_at": "2023-03-14T13:46:27-06:00",
"due_soon_time_threshold_interval": 0,
"due_soon_time_threshold_frequency": "day",
"account_id": 0,
"vehicle_id": 0,
"vehicle_renewal_type_id": 0,
"vehicle_archived_at": "2023-03-14T13:46:27-06:00",
"comments": [
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"commentable_type": "Contact",
"commentable_id": 0,
"user_id": 0,
"comment": "string",
"user_full_name": "string",
"user_image_url": "string",
"rich_content": {},
"html_content": "string",
"with_mentions": true
}
],
"comments_count": 0,
"custom_fields": {},
"is_sample": true,
"watchers_count": 0,
"watchable_options": {},
"bulk_watch_record": true,
"skip_automatic_watchers_callbacks": true,
"is_watched": true
}
Request could not be authenticated
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}
Unprocessable Entity
- application/json
- Schema
- Example (from schema)
- Example
Schema
errors object
typeitems string
{
"errors": {}
}
{
"errors": {
"field1": [
"error1",
"error2"
],
"field2": [
"error3"
]
}
}
Something unexpected happened
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}