> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hubspot Transition Ticket Stage: Inputs, Cost & CLI

> Move a HubSpot ticket to another pipeline stage while optionally writing close-check properties. Includes inputs, outputs, costs, and Deepline CLI examples.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=hubspot_transition_ticket_stage:{"ticket_id":"{{ticket_id}}","pipeline_stage":"{{pipeline_stage}}"}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Required Fields

| Name                     | Type     | Required | Default | Description                      |
| ------------------------ | -------- | -------- | ------- | -------------------------------- |
| `payload.ticket_id`      | `string` | Yes      |         | HubSpot ticket record ID.        |
| `payload.pipeline_stage` | `string` | Yes      |         | Target ticket stage internal ID. |

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute hubspot_transition_ticket_stage --payload '{
  "ticket_id": "string",
  "pipeline_stage": "string"
}' --json
```

### CLI flags

| Flag                        | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `--json`                    | Print machine-readable output.                      |
| `--wait`                    | Wait for terminal provider status when supported.   |
| `--debug`                   | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS`    | Max seconds to wait in wait mode.                   |
| `--poll-interval SECONDS`   | Polling interval in seconds during wait mode.       |
| `--timeout SECONDS`         | Request timeout in seconds.                         |
| `--connect-timeout SECONDS` | Connection timeout in seconds.                      |

## Provider API Context

<details>
  <summary>Show provider reference (optional)</summary>

  Source: [https://developers.hubspot.com/docs/apps/developer-platform/add-features/ui-extensibility/ui-components/standard-components/tag](https://developers.hubspot.com/docs/apps/developer-platform/add-features/ui-extensibility/ui-components/standard-components/tag)

  Learn about the Tag component for use in UI extensions.

  The `Tag` component renders a tag to label or categorize information or other components. Tags can be static or clickable for invoking functions.

  <Frame>
    <img alt="design-guidelines-tag" />
  </Frame>

  1. **Variant:** the color of the tag.
  2. **Tag text:** the text that communicates the tag's purpose.

  ```jsx theme={null} theme={null}
  import { Tag } from "@hubspot/ui-extensions";

  const Extension = () => {
    return (
      <Tag
        variant="success"
        onClick={() => {
          console.log("Tag clicked!");
        }}
        inline={true}
      >
        Success
      </Tag>
    );
  };
  ```

  ## Props

  | Prop      | Type                                                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                         |
  | --------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `onClick` | `() => void`                                                                 | A function that will be invoked when the tag is clicked. The function receives no arguments and its return value is ignored.                                                                                                                                                                                                                                                                                        |
  | `overlay` | Object                                                                       | Include a [Modal](/apps/developer-platform/add-features/ui-extensibility/ui-components/standard-components/modal) or [Panel](/apps/developer-platform/add-features/ui-extensibility/ui-components/standard-components/panel) component in this object to open it as an overlay on click. Learn more about [using overlays](/apps/developer-platform/add-features/ui-extensibility/ui-extensions-sdk#open-overlays). |
  | `variant` | `'default'` (default) \| `'warning'` \| `'success'` \| `'error'` \| `'info'` | The color of the alert. See the [variants section](#variants) for more information.                                                                                                                                                                                                                                                                                                                                 |

  ## Variants

  Using the `variant` prop, you can choose from one of five tag colors:

  <Frame>
    <img alt="ui-extension-components-tag-inline-variants" />
  </Frame>

  * `default` (default): for general tagging and labeling.
  * `success`: for indicating or confirming the success of an action.
  * `warning`: for indicating something that might be time-sensitive or of importance.
  * `error`: for indicating error or failure.
  * `info`: for conveying general information.

  ## Alignment

  Using the `inline` prop, you can set a tag to align side-by-side with surrounding text. Below are examples of inline tags next to single-line text and multi-line text.

  <Frame>
    <img alt="ui-extension-components-tag-inline-examples_3" />
  </Frame>

  ```jsx theme={null} theme={null}
  <Text>Some text over here</Text>;
  ```

  <Frame>
    <img alt="ui-extension-components-tag-inline-examples_2" />
  </Frame>

  ```jsx theme={null} theme={null}
  <Text>
    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam ac rhoncus velit, non tincidunt tortor. Aliquam nec
    ligula quis risus vehicula mattis id vitae orci. Suspendisse sed mattis metus, id iaculis enim.
  </Text>;
  ```

  <Frame>
    <img alt="ui-extension-components-tag-inline-examples_1" />
  </Frame>

  ```jsx theme={null} theme={null}
  <Text>
    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam ac rhoncus velit, non tincidunt tortor. Aliquam nec
    ligula quis risus vehicula mattis id vitae orci. Suspendisse sed mattis metus, id iaculis enim. Cras nisl erat,
    pulvinar sit amet nisl sit amet, feugiat pharetra urna.
  </Text>;
  ```

  ## Usage examples

  * Use a `default` tag to indicate that a customer is active.
  * Use a `success` tag to indicate that an item in a to-do list has been completed.
  * Use a `warning` tag to indicate that a deal is expiring soon.
  * Use an `error` tag to indicate that an error happened when trying to sync a specific property in a table.

  ## Guidelines

  * **DO:** make tag text concise and clear.
  * **DO:** ensure that tag variants are used consistently across the extension.
  * **DON'T:** use tags in place of buttons or links.
  * **DON'T:** rely on color alone to communicate the tag's meaning. Ensure that tag text is clear and helpful.

  ## Related components

  * [Toggle](/apps/developer-platform/add-features/ui-extensibility/ui-components/standard-components/toggle)
  * [Alert](/apps/developer-platform/add-features/ui-extensibility/ui-components/standard-components/alert)
  * [ProgressBar](/apps/developer-platform/add-features/ui-extensibility/ui-components/standard-components/progress-bar)
</details>

## Cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.