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

# Criar card de CRM

> Cria um novo card em uma etapa do funil de CRM, vinculando um contato existente.



## OpenAPI

````yaml https://api.jurichat.com/docs/client/openapi.json post /funnel-column-card/
openapi: 3.1.0
info:
  title: JuriChat API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.jurichat.com
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /funnel-column-card/:
    post:
      tags:
        - CRM
      summary: Criar card de CRM
      description: >-
        Cria um novo card em uma etapa do funil de CRM, vinculando um contato
        existente.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                channel:
                  type: string
                  description: 'Canal de origem do lead (ex.: WhatsApp, web). Opcional.'
                funnelId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  description: ID do funil de CRM onde o card será criado.
                columnId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  description: ID da etapa (coluna) do funil onde o card será posicionado.
                personId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  description: ID do contato vinculado ao card.
                customFields:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        pattern: ^[cC][^\s-]{8,}$
                        description: ID do campo personalizado.
                      name:
                        type: string
                        description: Nome do campo personalizado.
                      type:
                        type: string
                        description: Tipo do campo (texto, data, seleção etc.).
                      options:
                        description: Opções disponíveis para campos do tipo seleção.
                      value:
                        description: Valor preenchido no campo personalizado.
                    required:
                      - id
                    additionalProperties: false
                  description: Campos personalizados do card preenchidos na criação.
                tags:
                  type: array
                  items:
                    type: string
                  description: IDs das tags associadas ao card.
                userId:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
                  description: ID do usuário responsável pelo card. Opcional.
              required:
                - funnelId
                - columnId
                - personId
              additionalProperties: false
        required: true
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  showBadgeProgress:
                    type: boolean
                    description: Indica se a etapa exibe indicador de progresso por tempo.
                  timeLimitDays:
                    type: number
                    description: >-
                      Limite de dias configurado na etapa para permanência do
                      card.
                  columnChangedAt:
                    type: string
                    format: date-time
                    description: Data e hora em que o card foi movido para a etapa atual.
                  id:
                    type: string
                    pattern: ^[cC][^\s-]{8,}$
                    description: ID do card criado.
                  channel:
                    type: string
                    nullable: true
                    description: Canal de origem do lead. Null se não informado.
                  funnelId:
                    type: string
                    pattern: ^[cC][^\s-]{8,}$
                    description: ID do funil ao qual o card pertence.
                  columnId:
                    type: string
                    pattern: ^[cC][^\s-]{8,}$
                    description: ID da etapa atual do card.
                  personId:
                    type: string
                    pattern: ^[cC][^\s-]{8,}$
                    description: ID do contato vinculado ao card.
                  customFields:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          pattern: ^[cC][^\s-]{8,}$
                          description: ID do campo personalizado.
                        name:
                          type: string
                          description: Nome do campo personalizado.
                        type:
                          type: string
                          description: Tipo do campo (texto, data, seleção etc.).
                        options:
                          description: Opções disponíveis para campos do tipo seleção.
                        value:
                          description: Valor preenchido no campo personalizado.
                      required:
                        - id
                        - name
                        - type
                      additionalProperties: false
                    description: Campos personalizados do card.
                  tags:
                    type: array
                    items:
                      type: string
                    description: IDs das tags associadas ao card.
                  userId:
                    type: string
                    pattern: ^[cC][^\s-]{8,}$
                    description: ID do usuário responsável pelo card.
                required:
                  - showBadgeProgress
                  - timeLimitDays
                  - columnChangedAt
                  - id
                  - channel
                  - funnelId
                  - columnId
                  - personId
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  details: {}
                required:
                  - message
                  - statusCode
                additionalProperties: false
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  details: {}
                required:
                  - message
                  - statusCode
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-jurichat-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-jurichat-api-key.

````