> ## Documentation Index > Fetch the complete documentation index at: https://docs.kelviq.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a product > Creates a new product. ## OpenAPI ````yaml /api-reference/openapi.json post /catalog/products/ openapi: 3.0.0 info: title: kelviq API version: 1.0.0 description: >- API for interacting with kelviq services, derived from Python SDK documentation. servers: - url: https://api.kelviq.com/api/v1 description: kelviq API Server (General - specific operations might override) security: - bearerAuth: [] tags: - name: Products description: Catalog products. - name: Product Settings description: Per-product settings (currency, VPN/Tor/proxy, product URL). - name: Product Files description: Product images and downloadable assets. - name: Features description: Catalog features that can be granted as plan entitlements. - name: Plans description: Catalog plans (CRUD, publish, versions, prices). - name: Plan Entitlements description: Feature entitlements attached to a plan. - name: Plan Files description: Files attached to plans, and signed download links. - name: Media description: Generate presigned S3 upload URLs for product/plan images and files. - name: Partner description: Partner integration APIs (organization provisioning, lookup). - name: Charges description: >- One-time payments charged immediately against a customer's default payment method. paths: /catalog/products/: post: tags: - Products summary: Create a product description: Creates a new product. operationId: createCatalogProduct requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProductCreateRequest' responses: '201': description: Product created. content: application/json: schema: $ref: '#/components/schemas/Product' example: id: 762f0098-a8ef-4eed-b08b-f02043771b76 identifier: parity-deals name: ParityDeals description: '' createdBy: Geo Jacob modifiedOn: '2026-05-20T10:54:41.324224Z' images: - id: 2e025341-0f78-42cc-b814-8f059ac53339 name: web-app-manifest-512x512.png image: >- https://cdn.kelviq.com/media/staging/organizations/6/products/762f0098-a8ef-4eed-b08b-f02043771b76/f318dec5767c498482d9e5dffe8a3332/web-app-manifest-512x512.png ordering: 0 thumbnail: true enabled: true taxCode: saas '401': description: Unauthorized — missing or invalid API key security: - bearerAuth: [] components: schemas: ProductCreateRequest: type: object required: - name - taxCode description: Payload to create a new product. properties: name: type: string example: ParityDeals identifier: type: string description: Optional URL-safe slug. Auto-generated from name if not supplied. example: parity-deals description: type: string example: '' taxCode: type: string description: Tax code for the product. Must be one of the supported values. enum: - saas - saas_business - software - videocontent - informationservice - ebook - digitalgraphic - videogame - eservice - training example: saas imageKeys: type: array description: >- Temporary S3 keys (e.g. `tmp//`) returned by the upload endpoint. They will be moved into permanent storage and attached as `ProductImage` records. items: type: string example: - >- tmp/108713b0-1f81-42cf-a16c-c83b1d4d4148/web-app-manifest-512x512.png example: name: ParityDeals description: '' identifier: parity-deals imageKeys: - >- tmp/108713b0-1f81-42cf-a16c-c83b1d4d4148/web-app-manifest-512x512.png taxCode: saas Product: type: object description: >- A product in the catalog. Each product can have multiple plans, images and files. properties: id: type: string format: uuid readOnly: true example: 0d65f7c0-7e91-4f56-9b32-13a9a6a7c1de identifier: type: string description: >- Human-readable, URL-safe slug. Auto-generated from `name` if omitted on create. example: pro-suite name: type: string example: Pro Suite description: type: string example: Premium tools for growing teams. taxCode: type: string description: Tax code for the product. Must be one of the supported values. enum: - saas - saas_business - software - videocontent - informationservice - ebook - digitalgraphic - videogame - eservice - training example: saas createdBy: type: string readOnly: true description: Display name of the user who created the product. example: Jane Smith modifiedOn: type: string format: date-time readOnly: true example: '2025-04-12T08:21:14.910Z' images: type: array readOnly: true items: $ref: '#/components/schemas/ProductImage' ProductImage: type: object description: An image asset attached to a product. properties: id: type: string format: uuid readOnly: true description: Unique identifier for the image. example: 1f7e1b54-7c6f-4d7e-9a4f-2c9c2d8b9d31 name: type: string nullable: true description: Original filename or display name. example: hero-banner.png image: type: string readOnly: true description: Storage key / URL for the image asset. example: media/.../products///hero-banner.png ordering: type: integer description: Position of the image in the gallery. example: 0 thumbnail: type: boolean description: If `true`, this image is used as the product thumbnail. example: true enabled: type: boolean description: If `true`, the image is shown publicly. example: true securitySchemes: bearerAuth: type: http scheme: bearer description: >- The Server API Key obtained from the kelviq application. Pass as a Bearer token in the Authorization header. Example: 'Authorization: Bearer __YOUR_API_KEY__' ````