create-hubspot-ticket-on-failure.yaml

id: create-hubspot-ticket-on-failure
namespace: system

tasks:
  - id: create_ticket
    type: io.kestra.plugin.hubspot.tickets.Create
    apiKey: my_api_key
    subject: Workflow failed
    content: "{{ trigger.executionId }} has failed on {{ taskrun.startDate }}"
    stage: 3
    priority: HIGH

triggers:
  - id: on_failure
    type: io.kestra.plugin.core.trigger.Flow
    conditions:
      - type: io.kestra.plugin.core.condition.ExecutionStatusCondition
        in:
          - FAILED
          - WARNING
      - type: io.kestra.plugin.core.condition.ExecutionNamespaceCondition
        namespace: company
        comparison: PREFIX

extend:
  title: Create a ticket in Hubspot when a workflow fails
  description: >-
    This system flow will create a ticket in Hubspot anytime a workflow in a
    `company` namespace (or any nested child namespace) fails. 

    Using this pattern, you can track your Kestra workflow execution incidents
    alongside other tickets in Hubspot.

    You can customize that system flow by modifying the task, adding more tasks
    to the flow or adjusting the trigger conditions. Read more about that
    pattern in the [Administrator
    Guide](https://kestra.io/docs/administrator-guide/monitoring).

    Let's create a flow in the namespace with prefix `company` that will always
    fail.

    ```yaml
    id: failure_flow
    namespace: company.team

    tasks:
      - id: always_fails
        type: io.kestra.plugin.core.execution.Fail
    ```

    Whenever you run the `failure_flow`, it will trigger an execution of the
    `create_hubspot_ticket_on_failure` flow. As a result, a new ticket will be
    created in Hubspot helping you track failed workflows interacting with
    customer data alongside other customer tickets.
  tags:
    - System
    - Notifications
  ee: false
  demo: false
  meta_description: Create a Hubspot ticket when a workflow processing customer data fails