StyloDocs
Workflow blocks

Search Tickets

Search for Zendesk tickets

View as Markdown

zendesk/search-tickets — Search for Zendesk tickets.

Where it appears

The Search Tickets block lives in the Integrations group of the Workflow Builder. Connect the Zendesk integration before adding it.

Fields

FieldTypeRequiredDefaultDescription
querytext (supports references)YesZendesk search query using the Search API syntax (e.g. status:open assignee:me). Use literal text or <StepName.field> to inject a value from a previous step.
sortByselectNoField used to sort the matching tickets. Options: created_at, updated_at, priority, status.
sortOrderselectNoDirection to sort results: ascending or descending by the selected sort field. Options: asc, desc.

Inputs and outputs

Inputs are the configurable fields above. The block produces these outputs:

Outputs

Reference an output downstream with <Search Tickets.field>.

NameTypeDescription
successbooleanSuccess status
ticketsarrayArray of matching tickets
countnumberNumber of tickets found
errorstringError message if failed

Example

A minimal configuration for this block:

{
  "type": "zendesk/search-tickets",
  "config": {
    "query": "<PreviousStep.field>"
  }
}

Limits and failure modes

  • Requires a connected Zendesk integration. Calls fail if that integration is disconnected or its authorization has expired.
  • Required field (query) must be set, or the block fails validation before it runs.
  • On failure the error output is populated; downstream blocks that reference other outputs may not receive values.

On this page