---
title: "Criar"
method: POST
path: "/v2/panel/card"
tags: ["Cards"]
---

# Criar

`POST /v2/panel/card`

## Request body

- PublicReqCreatePanelCardDTO
  - `stepId` string, uuid, required — ID da etapa do painel onde o item deverá ser inserido.
  - `title` string, required — Título do item.
  - `description` string, nullable — Descrição do item.
  - `position` number, double, nullable — Posição do item na etapa.
  - `dueDate` string, date-time, nullable — Data de vencimento do item.
  - `responsibleUserId` string, uuid, nullable — ID do usuário responsável pelo item.
  - `tagIds` string[], nullable — IDss das etiquetas atribuídas.
  - `tagNames` string[], nullable — Nomes das etiquetas atribuídas. Este campo será ignorado caso `TagIds` seja definido.
  - `contactIds` string[], nullable — IDs dos contatos relacionados ao item.
  - `sessionId` string, uuid, nullable — ID da conversa relacionada ao item.
  - `monetaryAmount` number, double, nullable — Valor monetário atribuído ao item.
  - `customFields` object, nullable — Objeto chave-valor para definir valores de campos personalizados no item. Cada item do objeto deverá ter como nome a chave do campo personalizado. Caso a chave não corresponda a algum campo personalizado ou o tipo de dados do valor seja incompatível, o item será ignorado.
  - `metadata` object, nullable — Metadados relevantes para o item. Neste campo, pode ser salvo qualquer propriedade adicional para o item, na estrutura chave-valor. - Para adicionar um metadado: utilize uma chave não utilizada anteriormente neste item, atribuindo o novo valor; - Para atualizar um metadado: utilize a chave salva anteriormente neste item, atribuindo o novo valor; - Para remover um metadado: utilize a chave salva anteriormente, atribuindo valor nulo.

## Response `200`

Success

- PublicPanelCardDTOV2
  - `id` string, uuid
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `companyId` string, uuid
  - `panelId` string, uuid
  - `panelTitle` string, nullable
  - `stepId` string, uuid
  - `stepTitle` string, nullable
  - `stepPhase` 'NONE' | 'INITIAL' | 'FINAL', nullable
  - `position` number, double
  - `title` string, nullable
  - `description` string, nullable
  - `key` string, nullable
  - `number` integer
  - `dueDate` string, date-time, nullable
  - `isOverdue` boolean
  - `tagIds` string[], nullable
  - `sessionId` string, uuid, nullable
  - `monetaryAmount` number, double, nullable
  - `responsibleUserId` string, uuid, nullable
  - `responsibleUser` PublicPanelCardResponsibleUserDTO
    - `id` string, uuid
    - `name` string, nullable
  - `contactIds` string[], nullable
  - `contacts` PublicPanelCardContactDTO[], nullable
    - `id` string, uuid
    - `name` string, nullable
  - `customFields` object, nullable
  - `metadata` object, nullable
  - `status` 'OPEN' | 'WON' | 'LOST' | 'ARCHIVED'
  - `lostReason` LostReasonDTO
    - `id` string, uuid, nullable
    - `name` string, nullable

## Other responses

- `500` — Server Error

---

[API](https://skmtc.net/helena/apis/core.md) · [All operations](https://skmtc.net/helena/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/helena/core/versions/811b2cdd2ec2/schema)