> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a new custom action definition > Cree una nueva acción de workflow personalizada. export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => { const translations = { header: "Productos compatibles", description: "Se requiere uno de los siguientes productos o productos de ediciones superiores.", productNames: { marketing: "Marketing Hub", sales: "Sales Hub", service: "Service Hub", cms: "Content Hub" }, tiers: { free: "Gratuito", starter: "Starter", professional: "Pro", enterprise: "Enterprise" } }; const translateTier = tier => { if (!tier) return ''; const lowerTier = tier.toLowerCase(); return translations.tiers[lowerTier] || tier; }; const products = [{ name: marketing ? translations.productNames.marketing : '', level: translateTier(marketingLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg", alt: "Marketing Hub" }, { name: sales ? translations.productNames.sales : '', level: translateTier(salesLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg", alt: "Sales Hub" }, { name: service ? translations.productNames.service : '', level: translateTier(serviceLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg", alt: "Service Hub" }, { name: cms ? translations.productNames.cms : '', level: translateTier(cmsLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg", alt: "Content Hub" }].filter(product => product.name && product.level); if (products.length === 0) return null; return
{translations.description}
{products.map((product, index) =>
{product.alt} {product.name} - {product.level}
)}
; }; ## OpenAPI ````yaml specs/legacy/v4/automation-actions-v4-v4.json POST /automation/v4/actions/{appId} openapi: 3.0.1 info: title: Automation Actions V4 description: Basepom for all HubSpot Projects version: v4 x-hubspot-product-tier-requirements: marketing: PROFESSIONAL sales: PROFESSIONAL service: PROFESSIONAL cms: PROFESSIONAL commerce: PROFESSIONAL crmHub: PROFESSIONAL dataHub: PROFESSIONAL x-hubspot-related-documentation: - name: Custom Workflow Actions Guide url: >- https://developers.hubspot.com/docs/guides/api/automation/custom-workflow-actions servers: - url: https://api.hubapi.com security: [] tags: - name: Callbacks - name: Definitions - name: Functions - name: Revisions paths: /automation/v4/actions/{appId}: post: tags: - Definitions summary: Crear una nueva definición de acción personalizada description: Cree una nueva acción de workflow personalizada. operationId: post-/automation/v4/actions/{appId}_create parameters: - name: appId in: path description: El identificador único de la aplicación. required: true style: simple explode: false schema: type: integer format: int32 requestBody: content: application/json: schema: $ref: '#/components/schemas/PublicActionDefinitionEgg' required: true responses: '201': description: successful operation headers: Location: description: URL of the newly created resource style: simple explode: false schema: type: string content: application/json: schema: $ref: '#/components/schemas/PublicActionDefinition' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - developers-write components: schemas: PublicActionDefinitionEgg: required: - actionUrl - functions - inputFields - labels - objectTypes - published type: object properties: actionUrl: type: string description: El punto de terminación de la URL en el que se ejecuta la acción. archivedAt: type: integer description: La marca de tiempo que indica cuándo se archivó la acción. format: int64 executionRules: type: array items: $ref: '#/components/schemas/PublicExecutionTranslationRule' functions: type: array items: $ref: '#/components/schemas/PublicActionFunction' inputFieldDependencies: type: array items: oneOf: - $ref: '#/components/schemas/PublicSingleFieldDependency' - $ref: '#/components/schemas/PublicConditionalSingleFieldDependency' inputFields: type: array items: $ref: '#/components/schemas/PublicInputFieldDefinition' labels: type: object additionalProperties: $ref: '#/components/schemas/PublicActionLabels' description: >- Contiene varias etiquetas asociadas a la acción, incluidos nombres y descripciones. objectRequestOptions: $ref: '#/components/schemas/PublicObjectRequestOptions' objectTypes: type: array items: type: string outputFields: type: array items: $ref: '#/components/schemas/OutputFieldDefinition' published: type: boolean description: Indica si la acción está publicada y disponible para usarse. PublicActionDefinition: required: - actionUrl - functions - id - inputFields - labels - objectTypes - published - revisionId type: object properties: actionUrl: type: string archivedAt: type: integer format: int64 executionRules: type: array items: $ref: '#/components/schemas/PublicExecutionTranslationRule' functions: type: array items: $ref: '#/components/schemas/PublicActionFunctionIdentifier' id: type: string inputFieldDependencies: type: array items: oneOf: - $ref: '#/components/schemas/PublicSingleFieldDependency' - $ref: '#/components/schemas/PublicConditionalSingleFieldDependency' inputFields: type: array items: $ref: '#/components/schemas/PublicInputFieldDefinition' labels: type: object additionalProperties: $ref: '#/components/schemas/PublicActionLabels' objectRequestOptions: $ref: '#/components/schemas/PublicObjectRequestOptions' objectTypes: type: array items: type: string outputFields: type: array items: $ref: '#/components/schemas/OutputFieldDefinition' published: type: boolean revisionId: type: string PublicExecutionTranslationRule: required: - conditions - labelName type: object properties: conditions: type: object additionalProperties: type: object properties: {} description: >- Define las condiciones que se deben cumplir para que se aplique la regla de ejecución. labelName: type: string description: >- Especifica el nombre de la etiqueta asociada a la regla de ejecución. PublicActionFunction: required: - functionSource - functionType type: object properties: functionSource: type: string description: >- El código fuente o script que define el comportamiento de la función. functionType: type: string description: >- El tipo de función, con lo siguientes valores aceptados: POST_ACTION_EXECUTION, POST_FETCH_OPTIONS, PRE_ACTION_EXECUTION, PRE_FETCH_OPTIONS. enum: - POST_ACTION_EXECUTION - POST_FETCH_OPTIONS - PRE_ACTION_EXECUTION - PRE_FETCH_OPTIONS id: type: string description: El identificador único de la función de la acción. PublicSingleFieldDependency: title: SINGLE_FIELD required: - controllingFieldName - dependencyType - dependentFieldNames type: object properties: controllingFieldName: type: string description: El nombre del campo que controla la dependencia. dependencyType: type: string description: El tipo de dependencia, con el valor predeterminado "SINGLE_FIELD". default: SINGLE_FIELD enum: - SINGLE_FIELD dependentFieldNames: type: array items: type: string x-hubspot-sub-type-impl: true PublicConditionalSingleFieldDependency: title: CONDITIONAL_SINGLE_FIELD required: - controllingFieldName - controllingFieldValue - dependencyType - dependentFieldNames type: object properties: controllingFieldName: type: string description: El nombre del campo que determina la dependencia. controllingFieldValue: type: string description: El valor del campo de control que desencadena la dependencia. dependencyType: type: string description: >- El tipo de dependencia, con el valor predeterminado CONDITIONAL_SINGLE_FIELD. default: CONDITIONAL_SINGLE_FIELD enum: - CONDITIONAL_SINGLE_FIELD dependentFieldNames: type: array items: type: string x-hubspot-sub-type-impl: true PublicInputFieldDefinition: required: - isRequired - typeDefinition type: object properties: isRequired: type: boolean description: Indica si el campo de entrada es obligatorio. supportedValueTypes: type: array items: type: string enum: - STATIC_VALUE - OBJECT_PROPERTY typeDefinition: $ref: '#/components/schemas/PublicFieldTypeDefinition' PublicActionLabels: required: - actionName type: object properties: actionCardContent: type: string description: Contenido que se muestra en la tarjeta de la acción. actionDescription: type: string description: Una descripción de lo que hace la acción. actionName: type: string description: El nombre de la acción. appDisplayName: type: string description: El nombre visible de la aplicación asociada a la acción. executionRules: type: object additionalProperties: type: string description: Reglas que rigen la ejecución de la acción. inputFieldDescriptions: type: object additionalProperties: type: string description: Descripciones de cada campo de entrada. inputFieldLabels: type: object additionalProperties: type: string description: Etiquetas para los campos de entrada. inputFieldOptionLabels: type: object additionalProperties: type: object additionalProperties: type: string description: Etiquetas para las opciones disponibles en los campos de entrada. outputFieldLabels: type: object additionalProperties: type: string description: Etiquetas para los campos de salida. PublicObjectRequestOptions: required: - properties type: object properties: properties: type: array items: type: string OutputFieldDefinition: required: - typeDefinition type: object properties: typeDefinition: $ref: '#/components/schemas/FieldTypeDefinition' PublicActionFunctionIdentifier: required: - functionType type: object properties: functionType: type: string description: >- El tipo de función, con lo siguientes valores aceptados: POST_ACTION_EXECUTION, POST_FETCH_OPTIONS, PRE_ACTION_EXECUTION, PRE_FETCH_OPTIONS. enum: - POST_ACTION_EXECUTION - POST_FETCH_OPTIONS - PRE_ACTION_EXECUTION - PRE_FETCH_OPTIONS id: type: string description: El identificador único de la función. Error: required: - category - correlationId - message type: object properties: category: type: string description: La categoría del error context: type: object additionalProperties: type: array items: type: string description: Contexto de la condición de error example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identificador único para la solicitud. Incluye este valor con cualquier informe de error o ticket de asistencia. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: información adicional acerca del error items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Un mapa de nombres de enlaces a las URI asociadas que contienen documentación sobre el error o los pasos recomendados para solucionarlo message: type: string description: >- Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede example: An error occurred subCategory: type: string description: >- Una categoría específica que contiene detalles más concretos acerca del error 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 PublicFieldTypeDefinition: required: - name - options - type type: object properties: description: type: string description: Una explicación detallada del propósito del campo. fieldType: type: string description: >- El tipo de campo, con valores aceptados que incluyen booleancheckbox, calculation_equation, casilla de verificación, date, file, html, number, phonenumber, radio, select, text y textarea. enum: - booleancheckbox - calculation_equation - checkbox - date - file - html - number - phonenumber - radio - select - text - textarea helpText: type: string description: Información u orientación adicional sobre el campo. label: type: string description: Un nombre fácil de usar para el campo. name: type: string description: El nombre interno que identifica el campo. options: type: array items: $ref: '#/components/schemas/PublicOption' optionsUrl: type: string description: Una URL que ofrece opciones para el campo. referencedObjectType: type: string description: >- El tipo de objeto al que hace referencia el campo, cuyos valores aceptados incluyen OWNER. enum: - OWNER type: type: string description: >- El tipo de datos del campo, con valores aceptados que incluyen bool, date, datetime, enumeration, json, number, object_coordinates, phone_number y string. enum: - bool - date - datetime - enumeration - json - number - object_coordinates - phone_number - string FieldTypeDefinition: required: - externalOptions - name - options - schema - type - useChirp type: object properties: description: type: string description: Una explicación detallada del propósito y uso del campo. externalOptions: type: boolean description: Indica si las opciones del campo provienen de una fuente externa. externalOptionsReferenceType: type: string description: Especifica el tipo de referencia externa para las opciones. fieldType: type: string description: >- Describe el tipo de campo en la interfaz de usuario, y los valores aceptados son booleancheckbox, calculation_equation, checkbox, date, file, html, number, phonenumber, radio, select, text, textarea, unknown. enum: - booleancheckbox - calculation_equation - calculation_read_time - calculation_rollup - calculation_score - checkbox - date - file - html - number - phonenumber - radio - select - text - textarea - unknown helpText: type: string description: Información u orientación adicional sobre el campo. label: type: string description: La etiqueta fácil de usar para el campo. name: type: string description: El identificador único del campo. options: type: array items: $ref: '#/components/schemas/Option' optionsUrl: type: string description: Una URL que ofrece opciones para el campo. referencedObjectType: type: string description: >- Indica el tipo de objeto al que hace referencia el campo, con valores aceptados como OWNER. enum: - ABANDONED_CART - ACCEPTANCE_TEST - AD - AD_ACCOUNT - AD_CAMPAIGN - AD_GROUP - AI_FORECAST - ALL_PAGES - APPROVAL - APPROVAL_STEP - ATTRIBUTION - AUDIENCE - AUTOMATION_JOURNEY - AUTOMATION_PLATFORM_FLOW - AUTOMATION_PLATFORM_FLOW_ACTION - BET_ALERT - BET_DELIVERABLE_SERVICE - BLOG_LISTING_PAGE - BLOG_POST - CALL - CAMPAIGN - CAMPAIGN_BUDGET_ITEM - CAMPAIGN_SPEND_ITEM - CAMPAIGN_STEP - CAMPAIGN_TEMPLATE - CAMPAIGN_TEMPLATE_STEP - CART - CASE_STUDY - CHATFLOW - CLIP - CMS_URL - COMBO_EVENT_CONFIGURATION - COMMERCE_PAYMENT - COMMUNICATION - COMPANY - CONTACT - CONTACT_CREATE_ATTRIBUTION - CONTENT - CONTENT_AUDIT - CONTENT_AUDIT_PAGE - CONVERSATION - CONVERSATION_INBOX - CONVERSATION_SESSION - CRM_OBJECTS_DUMMY_TYPE - CRM_PIPELINES_DUMMY_TYPE - CTA - CTA_VARIANT - DATA_PRIVACY_CONSENT - DATA_SYNC_STATE - DEAL - DEAL_CREATE_ATTRIBUTION - DEAL_REGISTRATION - DEAL_SPLIT - DISCOUNT - DISCOUNT_CODE - DISCOUNT_TEMPLATE - EMAIL - ENGAGEMENT - EXPORT - EXTERNAL_WEB_URL - FEE - FEEDBACK_SUBMISSION - FEEDBACK_SURVEY - FILE_MANAGER_FILE - FILE_MANAGER_FOLDER - FOLDER - FORECAST - FORM - FORM_SUBMISSION_INBOUNDDB - GOAL_TARGET - GOAL_TARGET_GROUP - GOAL_TEMPLATE - GSC_PROPERTY - HUB - IMPORT - INVOICE - KEYWORD - KNOWLEDGE_ARTICLE - LANDING_PAGE - LEAD - LINE_ITEM - MARKETING_CALENDAR - MARKETING_CAMPAIGN_UTM - MARKETING_EMAIL - MARKETING_EVENT - MARKETING_EVENT_ATTENDANCE - MARKETING_SMS - MEDIA_BRIDGE - MEETING_EVENT - MIC - NOTE - OBJECT_LIST - ORDER - OWNER - PARTNER_ACCOUNT - PARTNER_CLIENT - PARTNER_CLIENT_REVENUE - PARTNER_SERVICE - PAYMENT_LINK - PAYMENT_SCHEDULE - PAYMENT_SCHEDULE_INSTALLMENT - PERMISSIONS_TESTING - PLAYBOOK - PLAYBOOK_QUESTION - PLAYBOOK_SUBMISSION - PLAYBOOK_SUBMISSION_ANSWER - PLAYLIST - PLAYLIST_FOLDER - PODCAST_EPISODE - PORTAL - PORTAL_OBJECT_SYNC_MESSAGE - POSTAL_MAIL - PRIVACY_SCANNER_COOKIE - PRODUCT - PRODUCT_OR_FOLDER - PROPERTY_INFO - PROSPECTING_AGENT_CONTACT_ASSIGNMENT - PUBLISHING_TASK - QUARANTINED_SUBMISSION - QUOTA - QUOTE - QUOTE_FIELD - QUOTE_MODULE - QUOTE_MODULE_FIELD - QUOTE_TEMPLATE - RESTORABLE_CRM_OBJECT - ROSTER - ROSTER_MEMBER - SALES_DOCUMENT - SALES_TASK - SALES_WORKLOAD - SALESFORCE_SYNC_ERROR - SCHEDULING_PAGE - SCHEMAS_BACKEND_TEST - SCORE_CONFIGURATION - SEQUENCE - SEQUENCE_ENROLLMENT - SEQUENCE_STEP - SEQUENCE_STEP_ENROLLMENT - SERVICE - SITE_PAGE - SNIPPET - SOCIAL_BROADCAST - SOCIAL_CHANNEL - SOCIAL_POST - SOCIAL_PROFILE - SOX_PROTECTED_DUMMY_TYPE - SOX_PROTECTED_TEST_TYPE - SUBMISSION_TAG - SUBSCRIPTION - TASK - TASK_TEMPLATE - TAX - TEMPLATE - TICKET - UNKNOWN - UNSUBSCRIBE - USER - VIEW - VIEW_BLOCK - WEB_INTERACTIVE schema: description: Define la estructura y las restricciones del campo. oneOf: - $ref: '#/components/schemas/IntegerFieldSchema' - $ref: '#/components/schemas/LongFieldSchema' - $ref: '#/components/schemas/DoubleFieldSchema' - $ref: '#/components/schemas/StringFieldSchema' - $ref: '#/components/schemas/BooleanFieldSchema' - $ref: '#/components/schemas/ArrayFieldSchema' - $ref: '#/components/schemas/ObjectFieldSchema' - $ref: '#/components/schemas/UnknownFieldSchema' type: type: string description: >- Especifica el tipo de datos del campo, con valores aceptados como bool, date, datetime, enumeration, json, number, object_coordinates, phone_number, string. enum: - bool - currency_number - date - datetime - enumeration - json - number - object_coordinates - phone_number - string useChirp: type: boolean description: Especifica si el campo usa la función Chirp. ErrorDetail: required: - message type: object properties: code: type: string description: El código de estado asociado al detalle del error context: type: object additionalProperties: type: array items: type: string description: Contexto de la condición de error example: '{missingScopes=[scope1, scope2]}' in: type: string description: El nombre del campo o parámetro en el que se encontró el error. message: type: string description: >- Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede subCategory: type: string description: >- Una categoría específica que contiene detalles más concretos acerca del error PublicOption: required: - label - value type: object properties: description: type: string description: Una descripción de la opción. displayOrder: type: integer description: La posición de la opción en relación con otras de la lista. format: int32 label: type: string description: Una etiqueta fácil de usar que identifica la opción. value: type: string description: El valor real de la opción. Option: required: - description - displayOrder - doubleData - hidden - label - readOnly - value type: object properties: description: type: string description: Una descripción de la opción. displayOrder: type: integer description: La posición del elemento en relación con otros de la lista. format: int32 doubleData: type: number description: Un valor numérico asociado a la opción. hidden: type: boolean description: Si la opción se muestra en la IU de HubSpot. label: type: string description: Una etiqueta fácil de usar que identifica la opción. readOnly: type: boolean description: Si la opción es de solo lectura. value: type: string description: El valor real de la opción. description: Una opción de propiedad de HubSpot IntegerFieldSchema: title: INTEGER required: - type type: object properties: maximum: type: integer description: El valor máximo permitido para el campo entero. format: int32 minimum: type: integer description: El valor mínimo permitido para el campo entero. format: int32 type: type: string description: El tipo de campo, que está configurado como INTEGER. default: INTEGER enum: - INTEGER x-hubspot-sub-type-impl: true LongFieldSchema: title: LONG required: - type type: object properties: maximum: type: integer description: El valor máximo permitido para el campo largo. format: int64 minimum: type: integer description: El valor mínimo permitido para el campo largo. format: int64 type: type: string description: El tipo de campo, que es de forma predeterminada es LONG. default: LONG enum: - LONG x-hubspot-sub-type-impl: true DoubleFieldSchema: title: DOUBLE required: - type type: object properties: maximum: type: number description: El valor máximo permitido para el campo doble. minimum: type: number description: El valor mínimo permitido para el campo doble. type: type: string description: Indica que el tipo de campo es DOUBLE. default: DOUBLE enum: - DOUBLE x-hubspot-sub-type-impl: true StringFieldSchema: title: STRING required: - type type: object properties: format: type: string description: >- Especifica el formato de la cadena, con los siguientes valores aceptados: DATE, DATE_TIME, OBJECT_COORDINATE, TIME, URI. enum: - DATE - DATE_TIME - OBJECT_COORDINATE - TIME - URI type: type: string description: >- Indica que el tipo es una cadena, con el valor predeterminado STRING. default: STRING enum: - STRING x-hubspot-sub-type-impl: true BooleanFieldSchema: title: BOOLEAN required: - type type: object properties: type: type: string description: >- Especifica el tipo de campo como BOOLEAN, lo que indica que el campo puede contener un valor verdadero o falso. default: BOOLEAN enum: - BOOLEAN x-hubspot-sub-type-impl: true ArrayFieldSchema: title: ARRAY required: - items - type type: object properties: items: description: >- Define el tipo de elementos que contiene el conjunto, que puede ser un número entero, largo, doble, cadena, booleano, otro conjunto o un objeto. oneOf: - $ref: '#/components/schemas/IntegerFieldSchema' - $ref: '#/components/schemas/LongFieldSchema' - $ref: '#/components/schemas/DoubleFieldSchema' - $ref: '#/components/schemas/StringFieldSchema' - $ref: '#/components/schemas/BooleanFieldSchema' - $ref: '#/components/schemas/ArrayFieldSchema' - $ref: '#/components/schemas/ObjectFieldSchema' - $ref: '#/components/schemas/UnknownFieldSchema' type: type: string description: Especifica que el campo es de tipo "ARRAY". default: ARRAY enum: - ARRAY x-hubspot-sub-type-impl: true ObjectFieldSchema: title: OBJECT required: - properties - type type: object properties: properties: type: object properties: {} description: Contiene las propiedades del objeto. type: type: string description: >- Especifica el tipo de campo, que de forma predeterminada es "OBJECT". default: OBJECT enum: - OBJECT x-hubspot-sub-type-impl: true UnknownFieldSchema: title: UNKNOWN required: - type type: object properties: type: type: string default: UNKNOWN enum: - UNKNOWN x-hubspot-sub-type-impl: true 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: '' developers-read: '' developers-write: '' ````