Definitions

Create a new custom action definition

Changed on

Create a new custom workflow action.

post/automation/actions/2026-09/{appId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/automation/actions/2026-09/{appId}
  • Auth
    API key in query parameter hapikey

Path parameters

appIdinteger required

The unique identifier of the app for which the extension definition is being created.

Request body

actionUrlstring required

The URL endpoint where the action is executed.

archivedAtinteger

The timestamp indicating when the action was archived.

labelsobject required

Holds various labels associated with the action, including names and descriptions.

objectTypesstring[] required

An array of strings representing the types of objects associated with the action.

publishedboolean required

Indicates whether the action is published and available for use.

Response

successful operation

actionUrlstring required

The URL endpoint where the action is executed. It is a string.

archivedAtinteger

A Unix timestamp in milliseconds representing when the action was archived. It is an integer.

idstring required

The unique identifier for the action definition. It is a string.

labelsobject required

An object containing labels for the action, with each property being a PublicActionLabels object.

objectTypesstring[] required

An array of strings representing the types of objects associated with the action.

publishedboolean required

A boolean indicating whether the action is published and available for use.

revisionIdstring required

The unique identifier for the current revision of the action definition. It is a string.

Changes

  • 2026-095b95e5eb45d5Revision changes
    • warning

      added the new OBJECT_TYPE enum value to the ///// response property for the response status

    • warning

      added the new OBJECT_TYPE enum value to the /////// response property for the response status

    • info

      added the new OBJECT_TYPE enum value to the request property /////

    • info

      added the new OBJECT_TYPE enum value to the request property ///////

  • 2026-095b95e5eb45d5Revision changes
    • warning

      added the new OBJECT_TYPE enum value to the ///// response property for the response status

    • warning

      added the new OBJECT_TYPE enum value to the /////// response property for the response status

    • info

      added the new OBJECT_TYPE enum value to the request property /////

    • info

      added the new OBJECT_TYPE enum value to the request property ///////