Zendesk · 0.1.0

Zendesk API

A Dock-hosted Zendesk API starter integration for Harbor. Importing it creates a local http_api port shell plus a Harbor-safe Zendesk action set for listing tickets, retrieving a single ticket, and creating a ticket with explicit approval. OAuth bearer tokens remain local to Harbor Node.

Community included customer-opshelpdesksupportticketszendesk
CRM Category
8 Action templates
1 Workflow templates
Zendesk Publisher
Manifest JSON Back to Catalog

Service Overview

Zendesk API is the official customer support and ticketing api from Zendesk for support, tickets, customer-ops, and helpdesk. This Hub entry keeps the service explanation, setup links, and Harbor-safe import path together so operators can review the integration before local credentials and policies are applied.

Zendesk API Service
Customer support and ticketing API Service type
https://your-subdomain.zendesk.com/ Base URL

What This Port Does

  • List Zendesk tickets with typed pagination, sorting, and archive filter inputs.
  • Retrieve a single Zendesk ticket by explicit ticket ID.
  • Create a Zendesk ticket using a bounded JSON request body under input.body.
  • Keeps service credentials local to Harbor Node so approval, execution, and audit stay inside the Harbor ecosystem.

Operator Setup

  • Create or confirm a Zendesk account, workspace, or tenant with the API access needed for the actions you plan to enable.
  • Import this Hub entry into Harbor, then replace the starter base URL with your tenant-specific service URL before testing actions.
  • Store the required Bearer token locally in Harbor Node using the Authorization header, then review automatic versus approval-required actions before publish.
  • Use the vendor setup guide linked below to create service credentials, scopes, or app registration settings that match your Harbor policy.

Install

Use in Harbor UI or the import-by-URL route. 
https://hub.breakwaterharbor.net/p/zendesk/zendesk-api
http_api Local shell
8 Actions
Community Required tier
Never Secrets imported

Actions

List Tickets JSON

{
  "slug": "list-tickets",
  "label": "List Tickets",
  "description": "List Zendesk tickets with typed pagination, sorting, and archive filter inputs.",
  "method": "GET",
  "path": "/api/v2/tickets",
  "inputs": {
    "parameters": [
      {
        "name": "page",
        "in": "query",
        "schema": {
          "type": "integer",
          "minimum": 1
        },
        "description": "Optional offset-based page number. Use this or cursor pagination fields if Harbor later adds deep-object query support."
      },
      {
        "name": "per_page",
        "in": "query",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100
        },
        "default": 25,
        "description": "Maximum number of tickets to return. Zendesk allows up to 100."
      },
      {
        "name": "sort_by",
        "in": "query",
        "schema": {
          "type": "string",
          "enum": [
            "id",
            "subject",
            "created_at",
            "updated_at",
            "status",
            "requester",
            "requester.name",
            "group",
            "assignee",
            "assignee.name"
          ]
        },
        "description": "Field used to sort the ticket list when using offset pagination."
      },
      {
        "name": "sort_order",
        "in": "query",
        "schema": {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        "description": "Sort direction for offset pagination."
      },
      {
        "name": "start_time",
        "in": "query",
        "schema": {
          "type": "integer",
          "minimum": 0
        },
        "description": "Optional Unix epoch filter for tickets created or updated after the given time."
      },
      {
        "name": "include",
        "in": "query",
        "schema": {
          "type": "string",
          "maxLength": 120
        },
        "description": "Optional comma-separated sideloads such as comment_count or custom_statuses."
      }
    ]
  },
  "approvalMode": "automatic",
  "requestBodyMode": "none",
  "resultMode": "json_summary"
}

Workflows

Ticket Review And Create Future workflow template for listing recent support tickets, inspecting a specific case, and operator-reviewed ticket creation.