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

# Criar contato

> Cria um contato na subconta informada.

**Autenticação:** envie um token de acesso da subconta ou um token de integração privada da subconta no cabeçalho `Authorization: Bearer <token>`. Permissão necessária: `contacts.write`. Envie também o cabeçalho `Version: v3`.



## OpenAPI

````yaml /openapi.json post /contacts/
openapi: 3.0.0
info:
  title: Salez API
  version: v3
  description: >-
    Referência de contatos da API Salez. Esta documentação apresenta cinco
    operações: consultar, criar, atualizar e criar ou atualizar contatos, além
    de consultar seus agendamentos.


    Use o cabeçalho `Version: v3` e um token autorizado para a subconta
    desejada. Os campos técnicos, tipos, rotas e códigos de resposta seguem a
    especificação de origem.
servers:
  - url: https://services.leadconnectorhq.com
    description: Servidor da API Salez.
security: []
tags:
  - name: Contatos
    description: Consulta e gerenciamento de contatos da Salez.
paths:
  /contacts/:
    post:
      tags:
        - Contatos
      summary: Criar contato
      description: >-
        Cria um contato na subconta informada.


        **Autenticação:** envie um token de acesso da subconta ou um token de
        integração privada da subconta no cabeçalho `Authorization: Bearer
        <token>`. Permissão necessária: `contacts.write`. Envie também o
        cabeçalho `Version: v3`.
      operationId: create-contact
      parameters:
        - name: Version
          in: header
          description: Versão da API. Utilize o valor `v3`.
          required: true
          schema:
            type: string
            enum:
              - v3
            example: v3
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateContactDtoV3'
      responses:
        '201':
          description: Resposta de sucesso.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateContactsSuccessfulResponseDtoV3'
        '400':
          description: Requisição inválida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestDTO'
        '401':
          description: Não autorizado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedDTO'
        '422':
          description: Não foi possível processar os dados enviados.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnprocessableDTO'
      security:
        - bearer: []
components:
  schemas:
    CreateContactDtoV3:
      type: object
      properties:
        firstName:
          type: string
          description: Primeiro nome do contato.
          example: Rosan
          nullable: true
        lastName:
          type: string
          description: Sobrenome do contato.
          example: Deo
          nullable: true
        name:
          type: string
          description: Nome completo do contato.
          example: Rosan Deo
          nullable: true
        email:
          type: string
          description: Endereço de e-mail do contato.
          example: rosan@deos.com
          nullable: true
        locationId:
          type: string
          description: ID da subconta em que o contato será criado.
          example: ve9EPM428h8vShlRW1KT
        gender:
          type: string
          description: Gênero do contato.
          example: male
        phone:
          type: string
          description: Número de telefone do contato.
          example: +1 888-888-8888
          nullable: true
        address1:
          type: string
          description: Endereço do contato.
          example: 3535 1st St N
          nullable: true
        city:
          type: string
          description: Cidade do contato.
          example: Dolomite
          nullable: true
        state:
          type: string
          description: Estado do contato.
          example: AL
          nullable: true
        postalCode:
          type: string
          description: Código postal do contato.
          example: '35061'
        website:
          type: string
          description: URL do site do contato.
          example: https://www.tesla.com
          nullable: true
        timezone:
          type: string
          description: Fuso horário do contato.
          example: America/Chihuahua
          nullable: true
        dnd:
          type: boolean
          description: Indica se o modo não perturbe (DND) está habilitado para o contato.
          example: true
        inboundDndSettings:
          description: >-
            Configurações de não perturbe (DND) para comunicações recebidas por
            canal do contato.
          example:
            all:
              status: active
              message: Do not contact me
          allOf:
            - $ref: '#/components/schemas/InboundDndSettingsSchema'
        tags:
          description: Lista de etiquetas a atribuir ao contato.
          example:
            - nisi sint commodo amet
            - consequat
          type: array
          items:
            type: string
        customFields:
          type: array
          description: Lista de valores de campos personalizados a atribuir ao contato.
          example:
            - id: 6dvNaf7VhkQ9snc5vnjJ
              key: my_custom_field
              fieldValue: My Text
          items:
            anyOf:
              - $ref: '#/components/schemas/TextField'
              - $ref: '#/components/schemas/LargeTextField'
              - $ref: '#/components/schemas/SingleSelectField'
              - $ref: '#/components/schemas/RadioField'
              - $ref: '#/components/schemas/NumericField'
              - $ref: '#/components/schemas/MonetoryField'
              - $ref: '#/components/schemas/CheckboxField'
              - $ref: '#/components/schemas/MultiSelectField'
              - $ref: '#/components/schemas/FileField'
        source:
          type: string
          description: Origem da criação do contato.
          example: public api
        dateOfBirth:
          type: object
          description: >-
            Data de nascimento do contato. Formatos aceitos: YYYY/MM/DD,
            MM/DD/YYYY, YYYY-MM-DD, MM-DD-YYYY, YYYY.MM.DD, MM.DD.YYYY,
            YYYY_MM_DD, MM_DD_YYYY.
          example: '1990-09-25'
          nullable: true
        country:
          type: string
          description: Código do país do contato no padrão ISO 3166-1 alfa-2.
          example: US
        companyName:
          type: string
          description: Nome da empresa do contato.
          example: DGS VolMAX
          nullable: true
        assignedTo:
          type: string
          example: y0BeYjuRIlDwsDcOHOJo
          description: ID do usuário.
        dndSettings:
          description: Configurações de não perturbe (DND) por canal do contato.
          example:
            call:
              status: active
              message: Do not call
            email:
              status: inactive
          allOf:
            - $ref: '#/components/schemas/DndSettingsSchemaV3'
      required:
        - locationId
    CreateContactsSuccessfulResponseDtoV3:
      type: object
      properties:
        contact:
          description: Dados do contato.
          example:
            id: seD4PfOuKoVMLkEZqohJ
            name: rubika deo
            firstName: rubika
            lastName: Deo
            email: rubika@deos.com
            phone: '+18832327657'
            locationId: ve9EPM428h8vShlRW1KT
          allOf:
            - $ref: '#/components/schemas/GetContactByIdSchemaV3'
    BadRequestDTO:
      type: object
      properties:
        statusCode:
          type: number
          example: 400
        message:
          type: string
          example: Bad Request
    UnauthorizedDTO:
      type: object
      properties:
        statusCode:
          type: number
          example: 401
        message:
          type: string
          example: 'Invalid token: access token is invalid'
        error:
          type: string
          example: Unauthorized
    UnprocessableDTO:
      type: object
      properties:
        statusCode:
          type: number
          example: 422
        message:
          example:
            - Unprocessable Entity
          type: array
          items:
            type: string
        error:
          type: string
          example: Unprocessable Entity
    InboundDndSettingsSchema:
      type: object
      properties:
        all:
          description: >-
            Configurações de não perturbe (DND) para comunicações recebidas,
            aplicadas a todos os canais.
          example:
            status: active
            message: Do not contact me
          allOf:
            - $ref: '#/components/schemas/InboundDndSettingSchema'
    TextField:
      type: object
      properties:
        id:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: 6dvNaf7VhkQ9snc5vnjJ
        key:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: my_custom_field
        fieldValue:
          type: string
          description: Valor de texto do campo personalizado (preferencial).
          example: My Text
        field_value:
          type: string
          deprecated: true
          description: Obsoleto. Utilize `fieldValue`.
          example: My Text
      required:
        - id
    LargeTextField:
      type: object
      properties:
        id:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: 6dvNaf7VhkQ9snc5vnjJ
        key:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: my_custom_field
        fieldValue:
          type: string
          description: Valor de texto longo do campo personalizado (preferencial).
          example: My Text
        field_value:
          type: string
          deprecated: true
          description: Obsoleto. Utilize `fieldValue`.
          example: My Text
      required:
        - id
    SingleSelectField:
      type: object
      properties:
        id:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: 6dvNaf7VhkQ9snc5vnjJ
        key:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: my_custom_field
        fieldValue:
          type: string
          description: >-
            Valor da opção selecionada para o campo personalizado
            (preferencial).
          example: My Selected Option
        field_value:
          type: string
          deprecated: true
          description: Obsoleto. Utilize `fieldValue`.
          example: My Selected Option
      required:
        - id
    RadioField:
      type: object
      properties:
        id:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: 6dvNaf7VhkQ9snc5vnjJ
        key:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: my_custom_field
        fieldValue:
          type: string
          description: >-
            Valor da opção de seleção única do campo personalizado
            (preferencial).
          example: My Selected Option
        field_value:
          type: string
          deprecated: true
          description: Obsoleto. Utilize `fieldValue`.
          example: My Selected Option
      required:
        - id
    NumericField:
      type: object
      properties:
        id:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: 6dvNaf7VhkQ9snc5vnjJ
        key:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: my_custom_field
        fieldValue:
          type: object
          description: Valor numérico do campo personalizado (preferencial).
          example: 100
        field_value:
          type: object
          deprecated: true
          description: Obsoleto. Utilize `fieldValue`.
          example: 100
      required:
        - id
    MonetoryField:
      type: object
      properties:
        id:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: 6dvNaf7VhkQ9snc5vnjJ
        key:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: my_custom_field
        fieldValue:
          type: object
          description: Valor monetário do campo personalizado (preferencial).
          example: 100.5
        field_value:
          type: object
          deprecated: true
          description: Obsoleto. Utilize `fieldValue`.
          example: 100.5
      required:
        - id
    CheckboxField:
      type: object
      properties:
        id:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: 6dvNaf7VhkQ9snc5vnjJ
        key:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: my_custom_field
        fieldValue:
          description: >-
            Lista de valores selecionados nas caixas de seleção do campo
            personalizado (preferencial).
          example:
            - test
            - test2
          type: array
          items:
            type: string
        field_value:
          deprecated: true
          description: Obsoleto. Utilize `fieldValue`.
          example:
            - test
            - test2
          type: array
          items:
            type: string
      required:
        - id
    MultiSelectField:
      type: object
      properties:
        id:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: 6dvNaf7VhkQ9snc5vnjJ
        key:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: my_custom_field
        fieldValue:
          description: >-
            Lista de valores selecionados para o campo personalizado
            (preferencial).
          example:
            - test
            - test2
          type: array
          items:
            type: string
        field_value:
          deprecated: true
          description: Obsoleto. Utilize `fieldValue`.
          example:
            - test
            - test2
          type: array
          items:
            type: string
      required:
        - id
    FileField:
      type: object
      properties:
        id:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: 6dvNaf7VhkQ9snc5vnjJ
        key:
          type: string
          description: Informe `id` ou `key` do campo personalizado.
          example: my_custom_field
        fieldValue:
          type: object
          description: >-
            Valor do arquivo enviado: mapa que associa UUIDs aos metadados e à
            URL de download de cada arquivo (preferencial).
          example:
            f31175d4-2b06-4fc6-b7bc-74cd814c68cb:
              meta:
                fieldname: 1HeGizb13P0odwgOgKSs
                originalname: IMG_20231215_164412935.jpg
                encoding: 7bit
                mimetype: image/jpeg
                size: 1786611
                uuid: f31175d4-2b06-4fc6-b7bc-74cd814c68cb
              url: >-
                https://services.leadconnectorhq.com/documents/download/w2M9qTZ0ZJz8rGt02jdJ
              documentId: w2M9qTZ0ZJz8rGt02jdJ
        field_value:
          type: object
          deprecated: true
          description: Obsoleto. Utilize `fieldValue`.
          example:
            f31175d4-2b06-4fc6-b7bc-74cd814c68cb:
              meta:
                fieldname: 1HeGizb13P0odwgOgKSs
                originalname: IMG_20231215_164412935.jpg
                encoding: 7bit
                mimetype: image/jpeg
                size: 1786611
                uuid: f31175d4-2b06-4fc6-b7bc-74cd814c68cb
              url: >-
                https://services.leadconnectorhq.com/documents/download/w2M9qTZ0ZJz8rGt02jdJ
              documentId: w2M9qTZ0ZJz8rGt02jdJ
      required:
        - id
    DndSettingsSchemaV3:
      type: object
      properties:
        call:
          description: Configurações de não perturbe (DND) para chamadas telefônicas.
          example:
            status: active
            message: Do not call
            code: all
          allOf:
            - $ref: '#/components/schemas/DndSettingSchema'
        email:
          description: Configurações de não perturbe (DND) para e-mail.
          example:
            status: active
            message: Do not email
            code: all
          allOf:
            - $ref: '#/components/schemas/DndSettingSchema'
        sms:
          description: Configurações de não perturbe (DND) para SMS.
          example:
            status: active
            message: Do not SMS
            code: all
          allOf:
            - $ref: '#/components/schemas/DndSettingSchema'
        whatsApp:
          description: Configurações de não perturbe (DND) para o WhatsApp.
          example:
            status: active
            message: Do not WhatsApp
            code: all
          allOf:
            - $ref: '#/components/schemas/DndSettingSchema'
        gmb:
          description: Configurações de não perturbe (DND) para o Google My Business.
          example:
            status: active
            message: Do not contact via GMB
            code: all
          allOf:
            - $ref: '#/components/schemas/DndSettingSchema'
        fb:
          description: Configurações de não perturbe (DND) para o Facebook.
          example:
            status: active
            message: Do not contact via FB
            code: all
          allOf:
            - $ref: '#/components/schemas/DndSettingSchema'
    GetContactByIdSchemaV3:
      type: object
      properties:
        id:
          type: string
          description: Identificador único do contato.
          example: seD4PfOuKoVMLkEZqohJ
        name:
          type: string
          description: Nome completo do contato.
          example: rubika deo
        locationId:
          type: string
          description: ID da subconta à qual o contato pertence.
          example: ve9EPM428h8vShlRW1KT
        firstName:
          type: string
          description: Primeiro nome do contato.
          example: rubika
        lastName:
          type: string
          description: Sobrenome do contato.
          example: Deo
        email:
          type: string
          description: Endereço de e-mail do contato.
          example: rubika@deos.com
        emailLowerCase:
          type: string
          description: E-mail do contato em letras minúsculas.
          example: rubika@deos.com
        timezone:
          type: string
          description: Fuso horário do contato.
          example: Asia/Calcutta
        companyName:
          type: string
          description: Nome da empresa do contato.
          example: DGS VolMAX
        phone:
          type: string
          description: Número de telefone do contato.
          example: '+18832327657'
        dnd:
          type: boolean
          description: Indica se o modo não perturbe (DND) está habilitado para o contato.
          example: true
        type:
          type: string
          description: Classificação do tipo de contato.
          example: lead
        source:
          type: string
          description: Origem da criação do contato.
          example: public api
        assignedTo:
          type: string
          description: ID do usuário responsável pelo contato.
          example: ve9EPM428h8vShlRW1KT
        address1:
          type: string
          description: Endereço do contato.
          example: 3535 1st St N
        city:
          type: string
          description: Cidade do contato.
          example: Birmingham
        state:
          type: string
          description: Estado do contato.
          example: AL
        country:
          type: string
          description: País do contato.
          example: US
        postalCode:
          type: string
          description: Código postal do contato.
          example: '35061'
        website:
          type: string
          description: URL do site do contato.
          example: https://www.tesla.com
        tags:
          description: Lista de etiquetas associadas ao contato.
          example:
            - nisi sint commodo amet
            - consequat
          type: array
          items:
            type: string
        dateOfBirth:
          type: string
          description: Data de nascimento do contato no formato YYYY-MM-DD.
          example: '1990-09-25'
        dateAdded:
          type: string
          description: Data e hora de criação do contato no padrão ISO 8601.
          example: '2021-07-02T05:18:26.704Z'
        dateUpdated:
          type: string
          description: Data e hora da última atualização do contato no padrão ISO 8601.
          example: '2021-07-02T05:18:26.704Z'
        attachments:
          type: string
          description: Lista de URLs de anexos associados ao contato.
          example: []
        ssn:
          type: string
          description: Número de seguridade social dos EUA (SSN), quando aplicável.
          example: 123-45-6789
        keyword:
          type: string
          description: Palavra-chave de busca associada ao contato.
          example: test
        firstNameLowerCase:
          type: string
          description: Primeiro nome do contato em letras minúsculas.
          example: rubika
        fullNameLowerCase:
          type: string
          description: Nome completo do contato em letras minúsculas.
          example: rubika deo
        lastNameLowerCase:
          type: string
          description: Sobrenome do contato em letras minúsculas.
          example: deo
        lastActivity:
          type: string
          description: Data e hora da última atividade do contato no padrão ISO 8601.
          example: '2021-07-16T11:39:30.564Z'
        customFields:
          description: Lista de valores dos campos personalizados do contato.
          example:
            - id: 6dvNaf7VhkQ9snc5vnjJ
              value: My Text
          type: array
          items:
            $ref: '#/components/schemas/CustomFieldSchema'
        businessId:
          type: string
          description: ID da empresa associada ao contato.
          example: 641c094001436dbc2081e642
        attributionSource:
          description: Dados da origem de atribuição da primeira interação do contato.
          example:
            url: Trigger Link
            campaign: Summer Sale
          allOf:
            - $ref: '#/components/schemas/AttributionSource'
        lastAttributionSource:
          description: Dados da origem de atribuição da última interação do contato.
          example:
            url: Organic Search
            campaign: Brand Awareness
          allOf:
            - $ref: '#/components/schemas/AttributionSource'
        visitorId:
          type: string
          description: >-
            `visitorId` é o identificador único atribuído a cada visitante do
            chat ao vivo.
          example: ve9EPM428h8vShlRW1KT
        dndSettings:
          description: Configurações de não perturbe (DND) por canal do contato.
          example:
            call:
              status: active
              message: Do not call
            email:
              status: inactive
          allOf:
            - $ref: '#/components/schemas/DndSettingsSchemaV3'
    InboundDndSettingSchema:
      type: object
      properties:
        status:
          type: string
          description: >-
            Status de não perturbe (DND) para comunicações recebidas neste
            canal.
          enum:
            - active
            - inactive
          example: active
        message:
          type: string
          description: >-
            Mensagem personalizada associada à configuração de não perturbe
            (DND) para comunicações recebidas.
          example: Please do not contact me via this channel
      required:
        - status
    DndSettingSchema:
      type: object
      properties:
        status:
          type: string
          description: Status de não perturbe (DND) para este canal.
          enum:
            - active
            - inactive
            - permanent
          example: active
        message:
          type: string
          description: >-
            Mensagem personalizada associada à configuração de não perturbe
            (DND).
          example: Do not contact via this channel
        code:
          type: string
          description: Código ou motivo de não perturbe (DND).
          example: OPTED_OUT
      required:
        - status
    CustomFieldSchema:
      type: object
      properties:
        id:
          type: string
          description: Identificador único do campo personalizado.
          example: MgobCB14YMVKuE4Ka8p1
        value:
          type: string
          description: Valor do campo personalizado.
          example: name
    AttributionSource:
      type: object
      properties:
        url:
          type: string
          description: Tipo de origem da atribuição.
          example: Trigger Link
        campaign:
          type: string
          description: Nome da campanha.
          example: Summer Sale 2024
          nullable: true
        utmSource:
          type: string
          description: Parâmetro UTM de origem.
          example: google
          nullable: true
        utmMedium:
          type: string
          description: Parâmetro UTM de meio.
          example: cpc
          nullable: true
        utmContent:
          type: string
          description: Parâmetro UTM de conteúdo.
          example: ad_variation_1
          nullable: true
        referrer:
          type: string
          description: URL de referência.
          example: https://www.google.com
          nullable: true
        campaignId:
          type: string
          description: ID da campanha.
          example: 641c094001436dbc2081e642
          nullable: true
        fbclid:
          type: string
          description: ID do clique no Facebook.
          example: fb.1.1674748390986.1171287961
          nullable: true
        gclid:
          type: string
          description: ID do clique no Google.
          example: >-
            CjOKCQjwnNyUBhCZARISAI9AYIFtNnIcWcYGIOQINz_ZoFI5SSLRRugSoPZoiEu27IZBY£1-MAIWmEaAo2VEALW_WCB
          nullable: true
        msclikid:
          type: string
          description: ID do clique na Microsoft.
          example: MS!AzEREREDJKSJD
          nullable: true
        dclid:
          type: string
          description: ID do clique no DoubleClick.
          example: EAIaIQobChMIw
          nullable: true
        fbc:
          type: string
          description: ID do navegador no Facebook.
          example: fb.1.1674748390986.1171287961
          nullable: true
        fbp:
          type: string
          description: ID do pixel do Facebook.
          example: fb. 1.1674748390986.1171287961
          nullable: true
        fbEventId:
          type: string
          description: ID do evento no Facebook.
          example: Mozilla/5.0
          nullable: true
        userAgent:
          type: string
          description: Identificação do navegador no formato user agent.
          example: Mozilla/5.0
          nullable: true
        ip:
          type: string
          description: Endereço IP do visitante.
          example: 58.111.106.198
          nullable: true
        medium:
          type: string
          description: Meio de atribuição, como pesquisa ou funil.
          example: survey
          nullable: true
        mediumId:
          type: string
          description: ID do meio de atribuição.
          example: FglfHAn30PRwsZVyQlKp
          nullable: true
      required:
        - url
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Token de acesso da subconta ou token de integração privada da subconta.
        Informe no cabeçalho Authorization usando Bearer. A leitura exige
        contacts.readonly; a criação e a atualização exigem contacts.write.
      type: http

````

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