---
title: "Retrieve action types"
method: GET
path: "/automation/2026-09-beta/action-types"
tags: ["Basic"]
---

# Retrieve action types

`GET /automation/2026-09-beta/action-types`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/automation/2026-09-beta/action-types`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `automation`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `workflows.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `workflows.delete`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `workflows.read`

Retrieve a list of available workflow action types. This endpoint can be used to understand the types of actions that can be incorporated into automation workflows, which is useful for developers looking to customize or extend workflow capabilities.

## Query parameters

- `objectTypeId` string

## Response `200`

successful operation

- CollectionResponseApiActionTypeDefinitionNoPaging
  - `results` ApiActionTypeDefinition[], required
    - `actionName` string, required: The human-readable action name.
    - `actionTypeId` string, required: The ID of the actionType
    - `groupId` string, required: The group-ID of the actionType
    - `inputFieldDefinitions` union[], required
      - union
        - ApiSimpleInputFieldDefinition
          - `description` string: A full description of this field.
          - `fieldDefinitionType` 'SIMPLE', required: The CRM type of field.
          - `isRequired` boolean, required: Whether or not this field is required
          - `label` string: The human-readable label of this field.
          - `name` string, required: The name of this field.
          - `type` 'bool' | 'currency_number' | 'date' | 'datetime' | 'enumeration' | 'json' | 'number' | 'object_coordinates' | 'phone_number' | 'string' | 'time_range', required: The type of field: SIMPLE
        - ApiEnumInputFieldDefinition
          - `description` string: Full description of the field.
          - `fieldDefinitionType` 'ENUM', required: Type of field: "ENUM"
          - `isRequired` boolean, required: If the field is required or not
          - `label` string: Human-readable label of the field
          - `name` string, required: Name of the field
          - `options` Option[], required
            - `description` string, required: A description of the option.
            - `displayOrder` integer, required: The position of the item relative to others in the list.
            - `doubleData` number, required: The data if it's a floating-point number
            - `hidden` boolean, required: Whether the option is displayed in HubSpot's UI.
            - `label` string, required: A user-friendly label that identifies the option.
            - `readOnly` boolean, required: Whether the option is read-only.
            - `value` string, required: The actual value of the option.
          - `type` 'bool' | 'currency_number' | 'date' | 'datetime' | 'enumeration' | 'json' | 'number' | 'object_coordinates' | 'phone_number' | 'string' | 'time_range', required: CRM type for the field:
        - ApiExternalEnumInputFieldDefinition
          - `description` string: Full description of this field
          - `fieldDefinitionType` 'EXTERNAL_ENUM', required: CRM type of the field
          - `isRequired` boolean, required: Whether or not this field is required
          - `label` string: Human-readable label of the field
          - `name` string, required: Name of the field
          - `optionsUrl` string: The URL to use to fetch the available options for this field.
          - `type` 'bool' | 'currency_number' | 'date' | 'datetime' | 'enumeration' | 'json' | 'number' | 'object_coordinates' | 'phone_number' | 'string' | 'time_range', required: Type of field: "ENUM"
    - `objectTypeIds` string[], required

## Other responses

- `default`: An error occurred.

## Changes

> 98 revisions in range; 5 not diffed.

- **2026-11-13** (2026-09-beta) `6ee0f25fe1ee`: 2 info
  - the security scope `automation` was added to the endpoint's security scheme `oauth2`
  - the security scope `workflows.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-03** (2026-09-beta) `9e4f80888836`: 3 warning
  - added the new `time_range` enum value to the `results/items/inputFieldDefinitions/items/oneOf[subschema #1: SIMPLE]/type` response property for the response status `200`
  - added the new `time_range` enum value to the `results/items/inputFieldDefinitions/items/oneOf[subschema #2: ENUM]/type` response property for the response status `200`
  - added the new `time_range` enum value to the `results/items/inputFieldDefinitions/items/oneOf[subschema #3: EXTERNAL_ENUM]/type` response property for the response status `200`
- **2026-07-13** (2026-09-beta) `437ab7f7961c`: 1 info
  - endpoint added
- **2026-07-13** (2026-09-beta) `614f5ff8daff`: 1 breaking
  - api path removed without deprecation
- **2026-05-22** (2026-09-beta) `c0e43a548369`: 3 info
  - the security scope `automation` was added to the endpoint's security scheme `oauth2`
  - the security scope `workflows-access` was removed from the endpoint's security scheme `oauth2`
  - the security scope `workflows-access-public-api` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/automation-automation-v4/changes/automation/2026-09-beta/action-types/get.md)

---

[API](https://skmtc.dev/hubspot/apis/automation-automation-v4.md) - [All operations](https://skmtc.dev/hubspot/apis/automation-automation-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/automation-automation-v4/revisions/6ee0f25fe1ee?raw)