---
title: "Create Comment"
method: POST
path: "/comments"
tags: ["Comments"]
---

# Create Comment

`POST /comments`

## Request

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

Creates a new comment

## Request body

- object
  - `title` string: The title of the Comment.
  - `comment` string, required: The content of the Comment message body.
  - `commentable_type` 'Contact' | 'FleetcorCard' | 'FuelEntry' | 'InventoryJournalEntry' | 'Issue' | 'Part' | 'PurchaseOrder' | 'ServiceEntry' | 'ServiceReminder' | 'SubmittedInspectionItem' | 'Vehicle' | 'VehicleAssignment' | 'Vendor' | 'WexCard' | 'WorkOrder', required: The type of record that the Comment will be left on. Must be associated with a matching `commentable_id`.
  - `commentable_id` integer, required

## Response `201`

OK

- Comment, nullable: A Comment
  - `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.
  - `commentable_type` 'Contact' | 'FleetcorCard' | 'FuelEntry' | 'InventoryJournalEntry' | 'Issue' | 'Part' | 'PurchaseOrder' | 'ServiceEntry' | 'ServiceReminder' | 'SubmittedInspectionItem' | 'Vehicle' | 'VehicleAssignment' | 'Vendor' | 'WexCard' | 'WorkOrder', required: The type of record that the Comment will be left on. Must be associated with a matching `commentable_id`.
  - `commentable_id` integer, required
  - `user_id` integer, required
  - `title` string: The title of the Comment.
  - `comment` string, required: The content of the Comment message body.
  - `user_full_name` string, required: The full name of the `User` who created the Comment.
  - `user_image_url` string, nullable, required: The image url for the `User` who created the Comment.
  - `rich_content` object, nullable, required
  - `html_content` string, nullable, required: The comment message body rendered as HTML.
  - `with_mentions` boolean, required: Indicates if the message body contains @mentions.

## Other responses

- `401`: Request could not be authenticated
- `403`: Insufficient permission to perform this operation
- `422`: Unprocessable Entity
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 1 warning
  - the `comment` request property's maxLength was set to `100000`

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/comments/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)