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

> ## Agent Instructions
> Leia /llms.txt antes de explorar páginas. A API HTTP usa Authorization: Bearer com o JWT da conta. A chave kl_live_ serve só ao assistente MCP e não substitui o JWT. Não invente rotas, hosts públicos, SDKs ou CLI. companyId e userId vêm da sessão. Consultas não aceitam SQL. Exclusão no assistente exige confirm=true. O webhook público é POST /webhook/leads.

# Criar lead

> Cria um lead no funil.



## OpenAPI

````yaml /openapi.json post /crm/newLead
openapi: 3.1.0
info:
  title: API KingLog
  version: 1.0.0
  description: >-
    API REST + JSON da KingLog. Produção: https://kinglog.app.br. Homologação é
    outro endereço, com os mesmos caminhos.
servers:
  - url: https://kinglog.app.br
    description: Produção
security: []
tags:
  - name: Sistema
  - name: Empresa
  - name: Usuários
  - name: Acesso
  - name: Projetos
  - name: Clientes
  - name: Equipes
  - name: Cargos
  - name: Quadros
  - name: Tarefas
  - name: Tags
  - name: Metas
  - name: OKR
  - name: Avisos
  - name: Notificações
  - name: Documentos
  - name: Sprints
  - name: Planner
  - name: CRM
  - name: Atendimento
  - name: Relatórios
  - name: Busca
  - name: Consultas
  - name: Produtos
  - name: SLA
  - name: Atendimento ao cliente
  - name: Chaves do assistente
paths:
  /crm/newLead:
    post:
      tags:
        - CRM
      summary: Criar lead
      description: Cria um lead no funil.
      operationId: crm.leads.create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
              required:
                - name
                - title
                - value
                - currency
                - column_id
                - companyId
                - userId
              properties:
                name:
                  type: string
                  description: Nome.
                  example: Ana Lima
                title:
                  type: string
                  description: Título.
                  example: Interesse no plano anual
                value:
                  type: integer
                  description: value (inteiro >= 0)
                  example: 0
                currency:
                  type: string
                  description: currency (BRL, USD, EUR ou GBP)
                  enum:
                    - BRL
                    - USD
                    - EUR
                    - GBP
                  example: BRL
                column_id:
                  type: string
                  description: Coluna do funil.
                  example: ID_DA_COLUNA
                companyId:
                  type: string
                  description: Empresa da sessão.
                  example: UUID_DA_EMPRESA
                userId:
                  type: string
                  description: Usuário da sessão.
                  example: UUID_DO_USUARIO
            examples:
              minimo:
                summary: Exemplo mínimo
                value:
                  name: Ana Lima
                  title: Interesse no plano anual
                  value: 0
                  currency: BRL
                  column_id: ID_DA_COLUNA
                  companyId: UUID_DA_EMPRESA
                  userId: UUID_DO_USUARIO
              completo:
                summary: Exemplo completo
                value:
                  name: Ana Lima
                  title: Interesse no plano anual
                  value: 0
                  currency: BRL
                  column_id: ID_DA_COLUNA
                  companyId: UUID_DA_EMPRESA
                  userId: UUID_DO_USUARIO
      responses:
        '200':
          description: >-
            A operação concluiu. success é true, code é SUCCESS e o conteúdo vem
            em data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessEnvelope'
              example:
                success: true
                data:
                  id: ID_DO_LEAD
                  name: Ana Lima
                  title: Interesse no plano anual
                  value: 0
                  currency: BRL
                  column_id: ID_DA_COLUNA
                  stage: null
                code: SUCCESS
        '400':
          description: Corpo ou combinação de campos recusada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                status: 400
                message: Mensagem descritiva do erro
                code: CODIGO
        '401':
          description: JWT ausente, inválido ou chave kl_live_ revogada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                status: 401
                message: Não autorizado
                code: UNAUTHORIZED
        '403':
          description: A pessoa, ou a chave restrita, não pode esse recurso.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                status: 403
                message: Sem permissão
                code: FORBIDDEN
        '404':
          description: Registro ou rota inexistente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                status: 404
                message: Não encontrado
                code: NOT_FOUND
      security:
        - bearerAuth: []
components:
  schemas:
    SuccessEnvelope:
      type: object
      required:
        - success
        - data
        - code
      properties:
        success:
          type: boolean
          example: true
        data:
          description: >-
            Conteúdo da operação. O exemplo 200 de cada rota preenche os campos
            do recurso.
        code:
          type: string
          example: SUCCESS
    ErrorEnvelope:
      type: object
      properties:
        success:
          type: boolean
          example: false
        status:
          type: integer
          example: 400
        message:
          type: string
        code:
          type: string
        errors:
          type: array
          items:
            type: object
        error:
          type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Todas as requisições devem incluir o JWT da conta no header
        Authorization no formato Bearer. Sem esse header a requisição é
        recusada.

````

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