> ## Documentation Index
> Fetch the complete documentation index at: https://docs.centralcart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Tag

> Cria uma tag.



## OpenAPI

````yaml /openapi/tags.yaml post /app/tag
openapi: 3.1.0
info:
  title: CentralCart API
  version: 1.0.0
servers:
  - url: https://api.centralcart.io/v1
    description: Produção
security:
  - bearerAuth: []
paths:
  /app/tag:
    post:
      tags:
        - Tags
      summary: Create Tag
      description: Cria uma tag.
      operationId: createTag
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagInput'
            example:
              name: VIP
              color: '#f59e0b'
      responses:
        '200':
          description: Tag criada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tag'
              example:
                id: 12
                store_id: 2
                name: VIP
                color: '#f59e0b'
                apply_to_all_packages: false
                created_at: '2024-09-04T15:44:47.000-03:00'
                updated_at: '2024-09-04T15:44:47.000-03:00'
        '422':
          description: >-
            Dados inválidos, nome repetido ou limite de 200 tags da loja
            atingido.
components:
  schemas:
    TagInput:
      type: object
      description: >-
        Na criação, `name` e `color` são obrigatórios. Na atualização, envie só
        os campos que mudam.
      properties:
        name:
          type: string
          description: Nome da tag, único na loja, até 64 caracteres
        color:
          type: string
          description: Cor em hexadecimal, como `#f59e0b`
        apply_to_all_packages:
          type: boolean
          description: >-
            Se `true`, a tag vale para todos os produtos e `package_ids` é
            ignorado
        package_ids:
          type: array
          description: IDs dos produtos vinculados à tag. Substitui a lista atual.
          items:
            type: number
    Tag:
      type: object
      properties:
        id:
          type: number
          description: ID da tag
        store_id:
          type: number
          description: ID da loja
        name:
          type: string
          description: Nome da tag
        color:
          type: string
          description: Cor da tag, em hexadecimal
        apply_to_all_packages:
          type: boolean
          description: Indica se a tag vale para todos os produtos da loja
        created_at:
          type: string
          description: Data de criação da tag
        updated_at:
          type: string
          description: Data da última atualização da tag
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Token de API gerado no painel da CentralCart.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.