ActionDefinitionCollection is a JSON Structure definition published by HubSpot, describing 2 properties, of which 1 is required. It conforms to the https://json-structure.org/draft/2020-12/schema meta-schema.
{
"type": "object",
"description": "A paginated collection of action definitions",
"name": "ActionDefinitionCollection",
"properties": {
"results": {
"type": "array",
"description": "List of action definitions",
"items": {
"type": "object",
"description": "A custom workflow action definition",
"properties": {
"id": {
"type": "string",
"description": "The unique identifier of the action definition"
},
"revisionId": {
"type": "string",
"description": "The current revision identifier"
},
"actionUrl": {
"type": "uri",
"description": "The URL that HubSpot will call when the action executes"
},
"labels": {
"type": "object",
"description": "Human-readable labels for the action",
"properties": {
"actionName": {
"type": "string",
"description": "The display name of the action"
},
"actionDescription": {
"type": "string",
"description": "A description of what the action does"
},
"appDisplayName": {
"type": "string",
"description": "The name of the app providing this action"
},
"actionCardContent": {
"type": "string",
"description": "Content to display on the action card in the workflow editor"
}
},
"required": [
"actionName"
]
},
"inputFields": {
"type": "array",
"description": "Input fields that users can configure for the action",
"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": "object"
},
"type": {
"type": "object"
},
"fieldType": {
"type": "object"
},
"label": {
"type": "object"
},
"description": {
"type": "object"
},
"options": {
"type": "object"
}
},
"required": [
"name",
"type"
]
},
"supportedValueTypes": {
"type": "array",
"description": "The types of values that can be provided for this field",
"items": {
"type": "object"
}
},
"isRequired": {
"type": "boolean",
"description": "Whether this field is required"
}
},
"required": [
"typeDefinition",
"supportedValueTypes"
]
}
},
"outputFields": {
"type": "array",
"description": "Output fields that the action returns",
"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": "object"
},
"type": {
"type": "object"
},
"fieldType": {
"type": "object"
},
"label": {
"type": "object"
},
"description": {
"type": "object"
},
"options": {
"type": "object"
}
},
"required": [
"name",
"type"
]
}
},
"required": [
"typeDefinition"
]
}
},
"objectTypes": {
"type": "array",
"description": "CRM object types this action can operate on",
"items": {
"type": "string",
"enum": [
"CONTACT",
"COMPANY",
"DEAL",
"TICKET",
"QUOTE"
]
}
},
"objectRequestOptions": {
"type": "object",
"description": "Options for requesting CRM object data",
"properties": {
"properties": {
"type": "array",
"description": "CRM properties to include in the action execution request",
"items": {
"type": "string"
}
}
}
},
"published": {
"type": "boolean",
"description": "Whether the action is published and available for use"
},
"functions": {
"type": "array",
"description": "Functions associated with this action",
"items": {
"type": "object",
"description": "A reference to a function associated with an action",
"properties": {
"functionType": {
"type": "string",
"description": "The type of function",
"enum": [
"PRE_ACTION_EXECUTION",
"PRE_FETCH_OPTIONS",
"POST_FETCH_OPTIONS",
"POST_ACTION_EXECUTION"
]
},
"id": {
"type": "string",
"description": "The unique identifier of the function"
}
},
"required": [
"functionType",
"id"
]
}
}
},
"required": [
"id",
"revisionId",
"actionUrl",
"labels",
"objectTypes"
]
}
},
"paging": {
"type": "object",
"description": "Pagination information",
"properties": {
"next": {
"type": "object",
"properties": {
"after": {
"type": "string",
"description": "Cursor for the next page"
}
}
}
}
}
},
"required": [
"results"
],
"$schema": "https://json-structure.org/draft/2020-12/schema"
}
Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.