> ## 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: Search Tickets

> Search HubSpot tickets by text query or filter groups for dedupe, SLA sweeps, owner queues, and GitHub sync checks. Includes SDK V2 examples, schemas, and cost.

Search HubSpot tickets by text query or filter groups for dedupe, SLA sweeps, owner queues, and GitHub sync checks.

> [!NOTE]
>
> Tool ID: `hubspot_search_tickets`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'hubspot_search_tickets',
  {
    "query": "software companies hiring engineers",
    "properties": [
      "example"
    ],
    "sorts": [
      "example"
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute hubspot_search_tickets --input '{
  "query": "software companies hiring engineers",
  "properties": [
    "example"
  ],
  "sorts": [
    "example"
  ]
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe hubspot_search_tickets --json` for the complete live contract.

## Input reference

Search HubSpot tickets with filters, text query, and paging.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.query` | `string` | No | — | Free-text HubSpot ticket search query. |
| `payload.properties` | `array` | No | — | Ticket properties to return for matching tickets. |
| `payload.sorts` | `array` | No | — | Sort strings such as `-createdate` or `subject`. |
| `payload.limit` | `integer` | No | — | Maximum results to return (max 100). |
| `payload.after` | `string \| number` | No | — | Paging cursor returned from a previous search response. |
| `payload.filter_groups` | `array` | No | — | HubSpot ticket search filter groups. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Search HubSpot tickets with filters, text query, and paging.",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text HubSpot ticket search query."
      },
      "properties": {
        "type": "array",
        "description": "Ticket properties to return for matching tickets.",
        "items": {
          "type": "string"
        }
      },
      "sorts": {
        "type": "array",
        "description": "Sort strings such as `-createdate` or `subject`.",
        "items": {
          "type": "string"
        }
      },
      "limit": {
        "type": "integer",
        "description": "Maximum results to return (max 100)."
      },
      "after": {
        "description": "Paging cursor returned from a previous search response.",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      },
      "filter_groups": {
        "type": "array",
        "description": "HubSpot ticket search filter groups.",
        "items": {
          "type": "object",
          "properties": {
            "filters": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "propertyName": {
                    "type": "string",
                    "description": "Property to filter on."
                  },
                  "operator": {
                    "type": "string",
                    "description": "HubSpot search operator (for example `EQ`, `IN`, `CONTAINS_TOKEN`)."
                  },
                  "value": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      }
                    ]
                  },
                  "values": {
                    "type": "array",
                    "description": "Multi-value filter payload for operators like `IN`.",
                    "items": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        }
                      ]
                    }
                  },
                  "highValue": {
                    "type": "string"
                  }
                },
                "required": [
                  "propertyName",
                  "operator"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "filters"
          ],
          "additionalProperties": false
        },
        "aliases": [
          "filterGroups"
        ]
      }
    },
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `record` | Yes | — | Provider response payload. |
| `result.meta` | `record` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "additionalProperties": {}
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": {}
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

* [HubSpot provider guide](https://deepline.com/docs/providers/hubspot/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.