InTouch Hub · Blue Isle Software

Zendesk

Read and create Zendesk support tickets and look up users via the Zendesk REST API v2.

zendesksupportticketshelpdesk

Zendesk

Read and create Zendesk support tickets and look up users via the Zendesk REST API v2.

Base URL: https://{subdomain}.zendesk.com/api/v2

Operations

operation method & endpoint required inputs
list_tickets GET /api/v2/tickets.json
get_ticket GET /api/v2/tickets/{ticketId}.json ticketId
create_ticket POST /api/v2/tickets.json subject, body (optional priority)
list_users GET /api/v2/users.json
search_users GET /api/v2/users/search.json?query=... query

Every operation also requires apiKey, subdomain, and email.

Authentication

Zendesk uses HTTP Basic auth with the credential string:

{email}/token:{apiKey}

base64-encoded into the Authorization: Basic <encoded> header. This tool builds that header for you from the email, subdomain, and apiKey inputs.

Getting an API token

  1. In Zendesk, open Admin Center.
  2. Go to Apps and integrations > APIs > Zendesk API.
  3. On the Settings tab, enable Token access and click Add API token.
  4. Copy the generated token (shown only once) — this is your apiKey.
  5. Use any agent/admin email on your account as email, and your account's subdomain (the part before .zendesk.com) as subdomain.

Inputs

Outputs

Examples

List the most recent tickets

apiKey:    <your-api-token>
subdomain: acme
email:     [email protected]
operation: list_tickets

Returns the tickets array in result with status 200.

Create a ticket

apiKey:    <your-api-token>
subdomain: acme
email:     [email protected]
operation: create_ticket
subject:   Printer on 3rd floor is offline
body:      The shared printer stopped responding around 9am.
priority:  high

Returns the created ticket JSON in result with status 201.

Find a user by email

apiKey:    <your-api-token>
subdomain: acme
email:     [email protected]
operation: search_users
query:     [email protected]