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

# Cadastra contato novo

> Cria prospect/cliente no CRIS a partir de sistemas externos.



## OpenAPI

````yaml /openapi/cris-rest.yaml post /cadastraCliente
openapi: 3.1.0
info:
  title: CRIS REST API
  version: 1.0.0
  description: >
    API REST do CRIS (Clínica de Resultado). Use o playground para enviar
    pedidos reais ao ambiente configurado em `servers`.

    Obtenha o token com **loginApi** e utilize-o no campo Bearer (header
    `Authorization`) nos endpoints em `cris.clinicaderesultado.com.br`.

    Operações na tag **Integrações IO** usam o host
    `io.clinicaderesultado.com.br` e autenticação **x-api-key** (não o Bearer do
    login).
servers:
  - url: https://cris.clinicaderesultado.com.br/rest/v1
    description: Produção
security:
  - bearerAuth: []
tags:
  - name: Autenticação
    description: Token para os demais endpoints
  - name: Entrada — Atração
    description: Cadastro e atualização de contatos
  - name: Entrada — Conversão e entrega
    description: Agendamentos
  - name: Entrada — Apoio
    description: Campanhas
  - name: Saída — Atração
    description: Lista de prospects e clientes
  - name: Saída — Conversão
    description: Orçamentos e vendas
  - name: Saída — Entrega e retenção
    description: Agendamentos
  - name: Saída — Apoio
    description: Listas de referência (IDs)
  - name: Integrações IO
    description: >-
      Webhooks em io.clinicaderesultado.com.br com header x-api-key (não utiliza
      loginApi / Bearer).
paths:
  /cadastraCliente:
    post:
      tags:
        - Entrada — Atração
      summary: Cadastra contato novo
      description: Cria prospect/cliente no CRIS a partir de sistemas externos.
      operationId: cadastraCliente
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CadastraClienteRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonResponse'
components:
  schemas:
    CadastraClienteRequest:
      type: object
      required:
        - clinica
        - nome
        - telefone
        - data_nascimento
        - canal
        - campanha
      properties:
        clinica:
          type: string
          description: ID da clínica (obrigatório em POST).
        nome:
          type: string
          description: Nome completo do contato.
        telefone:
          type: string
          description: Telefone no formato (DDD) XXXXX-XXXX.
        email:
          type: string
          format: email
          description: E-mail do contato.
        data_nascimento:
          type: string
          description: Data de nascimento em formato SQL (YYYY-MM-DD).
        observacao:
          type: string
        canal:
          type: integer
          description: ID do canal (listaCanal).
        campanha:
          type: integer
          description: ID da campanha (listaCampanha ou criaCampanha).
    JsonResponse:
      description: Resposta JSON do CRIS (estrutura variável por endpoint).
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token retornado por `POST /loginApi` (valor sem prefixo "Bearer" se a
        API esperar só o token; caso contrário inclua conforme o CRIS).

````