---
title: "Create Item"
method: POST
path: "/v2/catalog/{catalog_slug}/item"
tags: ["Catalog"]
---

# Create Item

`POST /v2/catalog/{catalog_slug}/item`

## Request

- Base URL: `https://api.expent.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.expent.ai/v2/catalog/{catalog_slug}/item`
- Auth: none declared. Required headers: `authorization`
- TypeScript: <https://skmtc.dev/expent/apis/expent-apis/docs/v2/catalog/:catalog_slug/item/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new catalog item using the provided details.

While adding tags to the catalog item, if the tag does not exist it will be created.

## Path parameters

- `catalog_slug` string, required

## Headers

- `authorization` string, required

## Request body

- CreateCatalogEntityExternalRequest
  - `name` string
  - `logo` string
  - `tags` union[]
    - union
      - object
      - string

## Response `201`

Successful Response

- CatalogEntityExternalResponse
  - `id` string, required
  - `name` string, required
  - `logo` string
  - `slug` string, required
  - `entity_type` string, required
  - `tags` Value[]
    - `name` string, required
    - `description` string
    - `color` string
  - `vendor_managers` CollaboratorResponse[]
    - `id` string, required
    - `auth_role` string
    - `type` 'USER' | 'TEAM' | 'ROLE', required: An enumeration.
    - `name` string
    - `email` string
    - `access_modes` AccessType[]
  - `field_matches` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/expent/apis/expent-apis.md) - [All operations](https://skmtc.dev/expent/apis/expent-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/expent/apis/expent-apis/revisions/ce1d50af5e2c?raw)