> ## 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 action types

> Obtenha uma lista de tipos de ações de fluxo de trabalho disponíveis. Este endpoint pode ser usado para entender os tipos de ações que podem ser incorporadas em fluxos de trabalho de automação, o que é útil para desenvolvedores que buscam personalizar ou estender os recursos do fluxo de trabalho.

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/2027-03-beta/automation-automation-v4-v2027-03-beta.json GET /automation/v4/2027-03-beta/action-types
openapi: 3.0.1
info:
  title: Automation Automation V4
  description: Basepom for all HubSpot Projects
  version: 2027-03-beta
  x-hubspot-product-tier-requirements:
    marketing: PROFESSIONAL
    sales: PROFESSIONAL
    service: PROFESSIONAL
    cms: PROFESSIONAL
    commerce: PROFESSIONAL
    crmHub: PROFESSIONAL
    dataHub: PROFESSIONAL
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Advanced
  - name: Basic
  - name: Batch
paths:
  /automation/v4/2027-03-beta/action-types:
    get:
      tags:
        - Basic
      summary: Recuperar tipos de ação
      description: >-
        Obtenha uma lista de tipos de ações de fluxo de trabalho disponíveis.
        Este endpoint pode ser usado para entender os tipos de ações que podem
        ser incorporadas em fluxos de trabalho de automação, o que é útil para
        desenvolvedores que buscam personalizar ou estender os recursos do fluxo
        de trabalho.
      operationId: >-
        get-/automation/v4/2027-03-beta/action-types_/automation/v4/2026-09-beta/action-types
      parameters:
        - name: objectTypeId
          in: query
          description: ''
          required: false
          style: form
          explode: true
          schema:
            type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/CollectionResponseApiActionTypeDefinitionNoPaging
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - automation
components:
  schemas:
    CollectionResponseApiActionTypeDefinitionNoPaging:
      required:
        - results
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/ApiActionTypeDefinition'
    ApiActionTypeDefinition:
      required:
        - actionName
        - actionTypeId
        - groupId
        - inputFieldDefinitions
        - objectTypeIds
      type: object
      properties:
        actionName:
          type: string
          description: O nome da ação em linguagem legível por humanos.
        actionTypeId:
          type: string
          description: O ID do actionType
        groupId:
          type: string
          description: O ID de grupo do actionType
        inputFieldDefinitions:
          type: array
          items:
            oneOf:
              - $ref: '#/components/schemas/ApiSimpleInputFieldDefinition'
              - $ref: '#/components/schemas/ApiEnumInputFieldDefinition'
              - $ref: '#/components/schemas/ApiExternalEnumInputFieldDefinition'
        objectTypeIds:
          type: array
          items:
            type: string
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: A categoria de erro
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexto sobre a condição do erro
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            Um identificador exclusivo para a solicitação. Inclua este valor em
            relatórios de erro ou tickets de suporte
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: mais informações sobre o erro
          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 as 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 mais detalhes específicos sobre
            o erro
      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
    ApiSimpleInputFieldDefinition:
      title: SIMPLE
      required:
        - fieldDefinitionType
        - isRequired
        - name
        - type
      type: object
      properties:
        description:
          type: string
          description: Uma descrição completa deste campo.
        fieldDefinitionType:
          type: string
          description: O tipo de campo do CRM.
          default: SIMPLE
          enum:
            - SIMPLE
        isRequired:
          type: boolean
          description: Se este campo é obrigatório ou não
        label:
          type: string
          description: O rótulo legível por humanos deste campo.
        name:
          type: string
          description: O nome deste campo.
        type:
          type: string
          description: 'O tipo de campo: SIMPLE'
          enum:
            - bool
            - currency_number
            - date
            - datetime
            - enumeration
            - json
            - number
            - object_coordinates
            - phone_number
            - string
            - time_range
      x-hubspot-sub-type-impl: true
    ApiEnumInputFieldDefinition:
      title: ENUM
      required:
        - fieldDefinitionType
        - isRequired
        - name
        - options
        - type
      type: object
      properties:
        description:
          type: string
          description: Descrição completa do campo.
        fieldDefinitionType:
          type: string
          description: 'Tipo de campo: "ENUM"'
          default: ENUM
          enum:
            - ENUM
        isRequired:
          type: boolean
          description: Se o campo é obrigatório ou não
        label:
          type: string
          description: Rótulo legível por humanos para o campo
        name:
          type: string
          description: Nome do campo
        options:
          type: array
          items:
            $ref: '#/components/schemas/Option'
        type:
          type: string
          description: 'Tipo de CRM do campo:'
          enum:
            - bool
            - currency_number
            - date
            - datetime
            - enumeration
            - json
            - number
            - object_coordinates
            - phone_number
            - string
            - time_range
      x-hubspot-sub-type-impl: true
    ApiExternalEnumInputFieldDefinition:
      title: EXTERNAL_ENUM
      required:
        - fieldDefinitionType
        - isRequired
        - name
        - type
      type: object
      properties:
        description:
          type: string
          description: Descrição completa deste campo
        fieldDefinitionType:
          type: string
          description: Tipo de CRM do campo
          default: EXTERNAL_ENUM
          enum:
            - EXTERNAL_ENUM
        isRequired:
          type: boolean
          description: Se este campo é obrigatório ou não
        label:
          type: string
          description: Rótulo legível por humanos para o campo
        name:
          type: string
          description: Nome do campo
        optionsUrl:
          type: string
          description: O URL a ser usado para obter as opções disponíveis para este campo.
        type:
          type: string
          description: 'Tipo de campo: "ENUM"'
          enum:
            - bool
            - currency_number
            - date
            - datetime
            - enumeration
            - json
            - number
            - object_coordinates
            - phone_number
            - string
            - time_range
      x-hubspot-sub-type-impl: true
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: O código de status associado ao detalhe do erro
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexto sobre a condição do erro
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: O nome do campo ou parâmetro no qual o erro foi encontrado.
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém mais detalhes específicos sobre
            o erro
      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.
    Option:
      required:
        - description
        - displayOrder
        - doubleData
        - hidden
        - label
        - readOnly
        - value
      type: object
      properties:
        description:
          type: string
          description: A description of the option.
        displayOrder:
          type: integer
          description: The position of the item relative to others in the list.
          format: int32
        doubleData:
          type: number
          description: Os dados, se forem números de ponto flutuante
        hidden:
          type: boolean
          description: Whether the option is displayed in HubSpot's UI.
        label:
          type: string
          description: A user-friendly label that identifies the option.
        readOnly:
          type: boolean
          description: Whether the option is read-only.
        value:
          type: string
          description: The actual value of the option.
      description: A HubSpot property option
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.hubspot.com/oauth/authorize
          tokenUrl: https://api.hubapi.com/oauth/v1/token
          scopes:
            automation: ''

````