HubSpot · Schema

ActionDefinitionPatch

Input for updating an action definition

AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationOperationsSales

Properties

Name Type Description
actionUrl string The URL that HubSpot will call when the action executes
labels object Human-readable labels for the action
inputFields array
outputFields array
objectTypes array
objectRequestOptions object Options for requesting CRM object data
published boolean
View JSON Schema on GitHub

JSON Schema

hubspot-custom-workflow-actions-action-definition-patch-schema.json Raw ↑
{
  "type": "object",
  "description": "Input for updating an action definition",
  "properties": {
    "actionUrl": {
      "type": "string",
      "description": "The URL that HubSpot will call when the action executes",
      "format": "uri",
      "example": "https://app.hubspot.com/contacts/12345"
    },
    "labels": {
      "type": "object",
      "description": "Human-readable labels for the action",
      "properties": {
        "actionName": {
          "type": "string",
          "description": "The display name of the action",
          "example": "Example Record"
        },
        "actionDescription": {
          "type": "string",
          "description": "A description of what the action does",
          "example": "This is an example description."
        },
        "appDisplayName": {
          "type": "string",
          "description": "The name of the app providing this action",
          "example": "Example Record"
        },
        "actionCardContent": {
          "type": "string",
          "description": "Content to display on the action card in the workflow editor",
          "example": "example-value"
        }
      },
      "required": [
        "actionName"
      ]
    },
    "inputFields": {
      "type": "array",
      "example": [
        {
          "typeDefinition": {},
          "supportedValueTypes": [
            {}
          ],
          "isRequired": true
        }
      ],
      "items": {
        "type": "object",
        "description": "An input field for the action",
        "properties": {
          "typeDefinition": {
            "type": "object",
            "description": "Definition of a field's type and configuration",
            "properties": {
              "name": {
                "type": "string",
                "description": "The programmatic name of the field",
                "example": "Example Record"
              },
              "type": {
                "type": "string",
                "description": "The data type of the field",
                "example": "STRING",
                "enum": [
                  "STRING",
                  "NUMBER",
                  "BOOL",
                  "DATE",
                  "DATETIME",
                  "ENUMERATION",
                  "PHONE_NUMBER",
                  "CURRENCY"
                ]
              },
              "fieldType": {
                "type": "string",
                "description": "The UI field type for input",
                "example": "TEXT",
                "enum": [
                  "TEXT",
                  "TEXTAREA",
                  "NUMBER",
                  "SELECT",
                  "BOOLEANCHECKBOX",
                  "DATE",
                  "FILE"
                ]
              },
              "label": {
                "type": "string",
                "description": "Human-readable label for the field",
                "example": "Example Record"
              },
              "description": {
                "type": "string",
                "description": "Description of the field",
                "example": "This is an example description."
              },
              "options": {
                "type": "array",
                "description": "Options for enumeration fields",
                "example": [
                  {
                    "label": "Example Record",
                    "value": "example-value",
                    "displayOrder": 100
                  }
                ],
                "items": {
                  "type": "object",
                  "description": "An option for an enumeration field",
                  "properties": {
                    "label": {
                      "type": "object"
                    },
                    "value": {
                      "type": "object"
                    },
                    "displayOrder": {
                      "type": "object"
                    }
                  },
                  "required": [
                    "label",
                    "value"
                  ]
                }
              }
            },
            "required": [
              "name",
              "type"
            ]
          },
          "supportedValueTypes": {
            "type": "array",
            "description": "The types of values that can be provided for this field",
            "example": [
              "STATIC_VALUE"
            ],
            "items": {
              "type": "string",
              "enum": [
                "STATIC_VALUE",
                "OBJECT_PROPERTY",
                "OUTPUT_FROM_PREVIOUS_ACTION"
              ]
            }
          },
          "isRequired": {
            "type": "boolean",
            "description": "Whether this field is required",
            "example": true
          }
        },
        "required": [
          "typeDefinition",
          "supportedValueTypes"
        ]
      }
    },
    "outputFields": {
      "type": "array",
      "example": [
        {
          "typeDefinition": {}
        }
      ],
      "items": {
        "type": "object",
        "description": "An output field returned by the action",
        "properties": {
          "typeDefinition": {
            "type": "object",
            "description": "Definition of a field's type and configuration",
            "properties": {
              "name": {
                "type": "string",
                "description": "The programmatic name of the field",
                "example": "Example Record"
              },
              "type": {
                "type": "string",
                "description": "The data type of the field",
                "example": "STRING",
                "enum": [
                  "STRING",
                  "NUMBER",
                  "BOOL",
                  "DATE",
                  "DATETIME",
                  "ENUMERATION",
                  "PHONE_NUMBER",
                  "CURRENCY"
                ]
              },
              "fieldType": {
                "type": "string",
                "description": "The UI field type for input",
                "example": "TEXT",
                "enum": [
                  "TEXT",
                  "TEXTAREA",
                  "NUMBER",
                  "SELECT",
                  "BOOLEANCHECKBOX",
                  "DATE",
                  "FILE"
                ]
              },
              "label": {
                "type": "string",
                "description": "Human-readable label for the field",
                "example": "Example Record"
              },
              "description": {
                "type": "string",
                "description": "Description of the field",
                "example": "This is an example description."
              },
              "options": {
                "type": "array",
                "description": "Options for enumeration fields",
                "example": [
                  {
                    "label": "Example Record",
                    "value": "example-value",
                    "displayOrder": 100
                  }
                ],
                "items": {
                  "type": "object",
                  "description": "An option for an enumeration field",
                  "properties": {
                    "label": {
                      "type": "object"
                    },
                    "value": {
                      "type": "object"
                    },
                    "displayOrder": {
                      "type": "object"
                    }
                  },
                  "required": [
                    "label",
                    "value"
                  ]
                }
              }
            },
            "required": [
              "name",
              "type"
            ]
          }
        },
        "required": [
          "typeDefinition"
        ]
      }
    },
    "objectTypes": {
      "type": "array",
      "example": [
        "standard"
      ],
      "items": {
        "type": "string"
      }
    },
    "objectRequestOptions": {
      "type": "object",
      "description": "Options for requesting CRM object data",
      "properties": {
        "properties": {
          "type": "array",
          "description": "CRM properties to include in the action execution request",
          "example": [
            "example-value"
          ],
          "items": {
            "type": "string"
          }
        }
      }
    },
    "published": {
      "type": "boolean",
      "example": true
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "ActionDefinitionPatch"
}