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

# Create a comment

`POST /comments`

## Request body

- CommentsCreate
  - `fields` unknown
  - `comment` object, required
    - `parent_type` 'Observation' | 'Post', required — Type of record being commented on
    - `parent_id` string, uuid, required — UUID of record being commented on
    - `body` string, required

## Response `200`

A list of comments

- ResultsComments
  - `total_results` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `results` Comment[], required
    - `id` integer — Unique auto-increment integer identifier.
    - `body` string
    - `created_at` string, date-time
    - `created_at_details` DateDetails, nullable
      - `date` string, required
      - `day` integer, required
      - `hour` integer, required
      - `month` integer, required
      - `week` integer, required
      - `year` integer, required
    - `created_at_utc` string, date-time
    - `flags` Flag[]
      - `id` integer, required — Unique auto-increment integer identifier.
      - `comment` string, nullable
      - `created_at` string, date-time
      - `created_at_utc` string, date-time, nullable
      - `flag` string
      - `flaggable_content` string, nullable
      - `flaggable_id` integer, nullable
      - `flaggable_type` string, nullable
      - `flaggable_user_id` integer, nullable
      - `resolved` boolean
      - `resolver_id` integer, nullable
      - `resolved_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `updated_at_utc` string, date-time, nullable
      - `user` User, nullable
        - `id` integer, required — Unique auto-increment integer identifier.
        - `uuid` string, uuid
        - `created_at` string, date-time
        - `description` string, nullable
        - `faved_project_ids` number[] — Ordered list of IDs of projects the user has faved
        - `icon` string, nullable
        - `icon_url` string, nullable
        - `identifications_count` integer
        - `journal_posts_count` integer
        - `annotated_observations_count` integer
        - `last_active` string, date-time
        - `login` string
        - `monthly_supporter` boolean, nullable
        - `name` string, nullable
        - `observations_count` integer
        - `orcid` string, nullable
        - `preferences` object
          - `prefers_community_taxa` boolean — Whether the user allows the Community Taxon to be the taxon their observation is associated with
          - `prefers_observation_fields_by` 'anyone' | 'curators' | 'observer'
          - `prefers_project_addition_by` 'any' | 'joined' | 'none'
        - `roles` string[]
        - `site` Site, nullable
          - `id` integer, required — Unique auto-increment integer identifier.
          - `icon_url` string — URL of an icon image for the site
          - `locale` string, nullable — Default language code for users of this site
          - `name` string — Full name of the site
          - `place_id` integer, nullable — Integer ID of the default search place for this site
          - `site_name_short` string, nullable — Short name for this site
          - `url` string
        - `site_id` integer, nullable
        - `spam` boolean
        - `species_count` integer
        - `suspended` boolean
        - `updated_at` string, date-time
      - `user_id` integer
      - `uuid` string, uuid, nullable
    - `hidden` boolean
    - `html` string
    - `moderator_actions` ModeratorAction[]
      - `id` integer, required — Unique auto-increment integer identifier.
      - `created_at` string
      - `created_at_details` DateDetails, nullable
        - `date` string, required
        - `day` integer, required
        - `hour` integer, required
        - `month` integer, required
        - `week` integer, required
        - `year` integer, required
      - `user` User, nullable
        - `id` integer, required — Unique auto-increment integer identifier.
        - `uuid` string, uuid
        - `created_at` string, date-time
        - `description` string, nullable
        - `faved_project_ids` number[] — Ordered list of IDs of projects the user has faved
        - `icon` string, nullable
        - `icon_url` string, nullable
        - `identifications_count` integer
        - `journal_posts_count` integer
        - `annotated_observations_count` integer
        - `last_active` string, date-time
        - `login` string
        - `monthly_supporter` boolean, nullable
        - `name` string, nullable
        - `observations_count` integer
        - `orcid` string, nullable
        - `preferences` object
          - `prefers_community_taxa` boolean — Whether the user allows the Community Taxon to be the taxon their observation is associated with
          - `prefers_observation_fields_by` 'anyone' | 'curators' | 'observer'
          - `prefers_project_addition_by` 'any' | 'joined' | 'none'
        - `roles` string[]
        - `site` Site, nullable
          - `id` integer, required — Unique auto-increment integer identifier.
          - `icon_url` string — URL of an icon image for the site
          - `locale` string, nullable — Default language code for users of this site
          - `name` string — Full name of the site
          - `place_id` integer, nullable — Integer ID of the default search place for this site
          - `site_name_short` string, nullable — Short name for this site
          - `url` string
        - `site_id` integer, nullable
        - `spam` boolean
        - `species_count` integer
        - `suspended` boolean
        - `updated_at` string, date-time
      - `action` string
      - `reason` string
      - `private` boolean
    - `parent_id` integer, nullable
    - `parent_type` string, nullable
    - `user` User, nullable
      - `id` integer, required — Unique auto-increment integer identifier.
      - `uuid` string, uuid
      - `created_at` string, date-time
      - `description` string, nullable
      - `faved_project_ids` number[] — Ordered list of IDs of projects the user has faved
      - `icon` string, nullable
      - `icon_url` string, nullable
      - `identifications_count` integer
      - `journal_posts_count` integer
      - `annotated_observations_count` integer
      - `last_active` string, date-time
      - `login` string
      - `monthly_supporter` boolean, nullable
      - `name` string, nullable
      - `observations_count` integer
      - `orcid` string, nullable
      - `preferences` object
        - `prefers_community_taxa` boolean — Whether the user allows the Community Taxon to be the taxon their observation is associated with
        - `prefers_observation_fields_by` 'anyone' | 'curators' | 'observer'
        - `prefers_project_addition_by` 'any' | 'joined' | 'none'
      - `roles` string[]
      - `site` Site, nullable
        - `id` integer, required — Unique auto-increment integer identifier.
        - `icon_url` string — URL of an icon image for the site
        - `locale` string, nullable — Default language code for users of this site
        - `name` string — Full name of the site
        - `place_id` integer, nullable — Integer ID of the default search place for this site
        - `site_name_short` string, nullable — Short name for this site
        - `url` string
      - `site_id` integer, nullable
      - `spam` boolean
      - `species_count` integer
      - `suspended` boolean
      - `updated_at` string, date-time
    - `user_id` integer, nullable
    - `updated_at` string, date-time
    - `updated_at_details` string, date-time
    - `uuid` string, uuid, required

---

[API](https://skmtc.net/inaturalist/apis/inaturalist-version-2-api.md) · [All operations](https://skmtc.net/inaturalist/apis/inaturalist-version-2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inaturalist/inaturalist-version-2-api/revisions/f739db716aaf/schema)