---
title: "CreateEntry Catalog V2"
method: POST
path: "/v2/catalog_entries"
tags: ["Catalog V2"]
---

# CreateEntry Catalog V2

`POST /v2/catalog_entries`

Create an entry within the catalog. We support a maximum of 50,000 entries per type.

If you call this API with a payload where the external_id and catalog_type_id match an existing entry, the existing entry will be updated.

## Request body

- CatalogV2CreateEntryRequestBody
  - `aliases` string[] — Optional aliases that can be used to reference this entry
  - `attribute_values` object, required — Values of this entry
  - `catalog_type_id` string, required — ID of this catalog type
  - `external_id` string — An optional alternative ID for this entry, which is ensured to be unique for the type
  - `name` string, required — Name is the human readable name of this entry
  - `rank` integer — When catalog type is ranked, this is used to help order things

## Response `201`

Created response.

- CatalogV2CreateEntryResponseBody
  - `catalog_entry` CatalogEntryV2, required
    - `aliases` string[], required — Optional aliases that can be used to reference this entry
    - `archived_at` string, date-time — When this entry was archived
    - `attribute_values` object, required — Values of this entry
    - `catalog_type_id` string, required — ID of this catalog type
    - `created_at` string, date-time, required — When this entry was created
    - `external_id` string — An optional alternative ID for this entry, which is ensured to be unique for the type
    - `id` string, required — ID of this catalog entry
    - `name` string, required — Name is the human readable name of this entry
    - `rank` integer, required — When catalog type is ranked, this is used to help order things
    - `updated_at` string, date-time, required — When this entry was last updated

---

[API](https://skmtc.net/incident/apis/incident-io.md) · [All operations](https://skmtc.net/incident/apis/incident-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incident/incident-io/revisions/602fc25ddd76/schema)