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

# Criar um contato

> Criar um novo contato.



## OpenAPI

````yaml /api-reference/openapi.json post /api/management/contacts
openapi: 3.0.0
info:
  title: Olie API
  version: 1.0.0
  description: >
    # Introdução 👋


    Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/).
    Aqui você encontra as referências e exemplos de uso dos nossos endpoints.


    Para uma visão completa, recomendamos fortemente que você leia a
    [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá
    estão detalhados tópicos essenciais como
    [autenticação](https://docs.olie.ai/api-reference/introduction/authentication),
    [estrutura de
    respostas](https://docs.olie.ai/api-reference/general/response-structure),
    [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros
    guias de integração.


    No Postman, esta coleção foca nas informações específicas de cada requisição
    (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e
    desenvolvimento.
servers:
  - url: https://api.olie.ai
security:
  - BearerAuth: []
paths:
  /api/management/contacts:
    post:
      tags:
        - contacts
      summary: Criar um contato
      description: Criar um novo contato.
      operationId: criarContato
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  maxLength: 255
                  description: Nome do contato
                role:
                  type: string
                  description: Cargo/função do contato
                email:
                  type: string
                  maxLength: 254
                  description: E-mail do contato
                  format: email
                phone:
                  type: string
                  maxLength: 30
                  description: Telefone do contato
                description:
                  type: string
                  maxLength: 255
                  description: Descrição do contato
                customers:
                  type: object
                  description: >-
                    Clientes vinculados ao contato. Envie to_add (clientes a
                    adicionar) e to_rem (clientes a remover).
                  properties:
                    to_add:
                      type: array
                      description: IDs dos clientes a adicionar
                      items:
                        type: string
                        format: uuid
                    to_rem:
                      type: array
                      description: IDs dos clientes a remover
                      items:
                        type: string
                        format: uuid
                tags:
                  type: object
                  description: >-
                    Etiquetas do contato. Envie to_add (etiquetas a adicionar) e
                    to_rem (etiquetas a remover).
                  properties:
                    to_add:
                      type: array
                      description: >-
                        Etiquetas a adicionar: use id para vincular etiqueta
                        existente ou name (e opcionalmente color) para criar
                        nova
                      items:
                        type: object
                        properties:
                          id:
                            type: string
                            description: ID da etiqueta existente
                            format: uuid
                          name:
                            type: string
                            maxLength: 255
                            description: Nome da nova etiqueta
                          color:
                            type: string
                            pattern: ^#[0-9A-Fa-f]{6}$
                            description: 'Cor em hex (ex: #FF0000)'
                    to_rem:
                      type: array
                      description: Etiquetas a remover
                      items:
                        type: object
                        properties:
                          id:
                            type: string
                            description: ID da etiqueta a remover
                            format: uuid
                form_answers:
                  type: array
                  description: Respostas do formulário dinâmico
                  items: {}
              required:
                - name
            example:
              name: João Silva
              role: Gerente de Vendas
              email: joao.silva@exemplo.com.br
              phone: (91) 99999-0000
              description: Contato principal da empresa
              customers:
                to_add: []
                to_rem: []
              tags:
                to_add: []
                to_rem: []
      responses:
        '200':
          description: Sucesso
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
              example: '*'
            Access-Control-Expose-Headers:
              schema:
                type: string
              example: '*'
            Cache-Control:
              schema:
                type: string
              example: no-cache, private
            Date:
              schema:
                type: string
              example: Fri, 16 Jan 2026 18:03:26 GMT
            X-Ratelimit-Limit:
              schema:
                type: integer
              example: 160
            X-Ratelimit-Remaining:
              schema:
                type: integer
              example: 157
            Transfer-Encoding:
              schema:
                type: string
              example: chunked
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````