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

# Retrieve Auto Association defaults

> Recupere os comportamentos padrão de autoassociação para um tipo de objeto especificado na sua conta da HubSpot. Esse endpoint permite entender as configurações padrão aplicadas às associações automáticas, o que pode ajudar a gerenciar e configurar associações de CRM de forma eficaz.

> [accordion] Supported products

> [accordion] Required Scopes


## OpenAPI

````yaml specs/2027-03-beta/crm-activity-auto-associations-v2027-03-beta.json GET /crm/auto-associations/2027-03-beta/{subjectObjectType}/defaults
openapi: 3.0.1
info:
  title: CRM Activity Auto Associations
  description: Basepom for all HubSpot Projects
  version: 2027-03-beta
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Basic
  - name: Batch
paths:
  /crm/auto-associations/2027-03-beta/{subjectObjectType}/defaults:
    get:
      tags:
        - Basic
      summary: Recuperar padrões de associação automática
      description: >-
        Recupere os comportamentos padrão de autoassociação para um tipo de
        objeto especificado na sua conta da HubSpot. Esse endpoint permite
        entender as configurações padrão aplicadas às associações automáticas, o
        que pode ajudar a gerenciar e configurar associações de CRM de forma
        eficaz.
      operationId: get-/crm/auto-associations/2027-03-beta/{subjectObjectType}/defaults
      parameters:
        - name: subjectObjectType
          in: path
          description: >-
            O tipo de objeto para o qual recuperar os comportamentos padrão de
            autoassociação. Este parâmetro identifica o tipo específico de
            objeto do CRM, como contatos ou negócios.
          required: true
          style: simple
          explode: false
          schema:
            type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/CollectionResponseAutoAssociationBehaviorNoPaging
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security: []
components:
  schemas:
    CollectionResponseAutoAssociationBehaviorNoPaging:
      required:
        - results
      type: object
      properties:
        results:
          type: array
          description: >-
            Uma matriz de objetos AutoAssociationBehavior, cada um representando
            uma configuração de comportamento específica para autoassociações.
            Esta matriz contém os detalhes de como diferentes tipos de objetos
            são associados automaticamente no CRM.
          items:
            $ref: '#/components/schemas/AutoAssociationBehavior'
    AutoAssociationBehavior:
      required:
        - associationCustomization
        - engagementType
        - id
        - subjectObjectTypeId
        - targetObjectTypeId
      type: object
      properties:
        associationCustomization:
          type: string
          description: >-
            Especifica o comportamento de personalização para a associação. É
            uma string e pode ter um dos seguintes valores: "NO_LOGGING",
            "PRIMARY_COMPANY", "X_MOST_RECENTLY_ASSOCIATED",
            "ONE_MOST_RECENTLY_ASSOCIATED", "FIVE_MOST_RECENTLY_ASSOCIATED".
          enum:
            - FIVE_MOST_RECENTLY_ASSOCIATED
            - NO_LOGGING
            - ONE_MOST_RECENTLY_ASSOCIATED
            - PRIMARY_COMPANY
            - X_MOST_RECENTLY_ASSOCIATED
        engagementType:
          type: string
          description: >-
            O tipo de engajamento que está sendo associado. É representado como
            uma string.
        id:
          type: string
          description: >-
            O identificador exclusivo para esta configuração específica de
            comportamento de autoassociação.
        subjectObjectTypeId:
          type: string
          description: >-
            O identificador exclusivo do tipo de objeto de assunto envolvido na
            associação. É uma string.
        targetObjectTypeId:
          type: string
          description: >-
            O identificador exclusivo para o tipo de objeto de destino envolvido
            na associação. É uma string.
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: >-
            Categoria de erro, que fornece uma classificação de alto nível do
            erro.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Contexto sobre a condição de erro, representado como um objeto com
            propriedades adicionais que podem incluir arrays de strings.
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            O identificador exclusivo da solicitação. Inclua este valor em
            relatórios de erro ou tickets de suporte. Ele é formatado como um
            UUID.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: >-
            Uma matriz que fornece mais informações sobre o erro. Cada item
            informa condições de erro específicas.
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Um mapa de nomes de links para URIs associados que contêm
            documentação sobre o erro ou etapas de correção recomendadas.
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado.
          example: An error occurred
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém detalhes mais específicos sobre
            o erro. Esta é uma propriedade de string.
      description: >-
        Representa uma resposta de erro retornada pela API quando uma operação
        falha. Este componente é usado em vários endpoints para fornecer
        informações detalhadas sobre o erro encontrado.
      example:
        message: Invalid input (details will vary based on the error)
        correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
        category: VALIDATION_ERROR
        links:
          knowledge-base: https://www.hubspot.com/products/service/knowledge-base
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: >-
            O código de status associado ao detalhe do erro, representado como
            uma string.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Contexto sobre a condição de erro, representado como um objeto. Este
            objeto pode conter propriedades adicionais, cada uma sendo um array
            de strings, fornecendo mais detalhes sobre o erro.
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: >-
            O nome do campo ou parâmetro em que o erro foi encontrado. É uma
            string que ajuda a identificar a origem do erro.
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado. Esta é uma propriedade
            obrigatória.
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém detalhes mais específicos sobre
            o erro, fornecida como uma string.
      description: >-
        Representa informações detalhadas sobre um erro ocorrido na API. Este
        componente é usado para fornecer contexto e detalhes adicionais sobre os
        erros, geralmente como parte de uma resposta de erro.
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'

````