Zendesk integration

What it does

The Zendesk integration lets you run support automations on behalf of any client whose helpdesk you manage. Connect a Zendesk Support account once, then create and update tickets, post agent or internal comments, sync end-users and organizations, and route live ticket events (created, updated, solved) into the rest of your workflow without writing any code.

Connect a Zendesk account

1. In TaskJuice, open Settings -> Connections and choose Add connection -> Zendesk Support.
2. Enter your client's Zendesk subdomain (the part before .zendesk.com in the help-center URL, e.g. acme for acme.zendesk.com).
3. Sign in with the Zendesk account you (or your client) want TaskJuice to act on behalf of and approve the requested access.

Scopes requested: read, write. The grant can be audited or revoked at any time from the Zendesk Admin Center under Apps and integrations -> APIs -> OAuth clients.

Triggers

• zendesk/ticket-created. Fires when a new ticket is created in the Zendesk account.
• zendesk/ticket-updated. Fires when an existing ticket is updated (status, priority, assignee, tags, or comment).
• zendesk/ticket-solved. Fires when a ticket transitions to the solved status.

Every trigger verifies the inbound POST with HMAC-SHA256 over ${timestamp}${rawBody} using the signing secret from the Zendesk webhook configuration. The digest arrives base64-encoded on the X-Zendesk-Webhook-Signature header, and the timestamp on X-Zendesk-Webhook-Signature-Timestamp. Configure each webhook in Zendesk under Admin Center -> Apps and integrations -> Webhooks, then attach it to a Zendesk trigger that fires on the matching condition.

Actions

• zendesk/list-tickets. List tickets in the account, paginated by cursor.
• zendesk/get-ticket. Look up a single ticket by ID.
• zendesk/create-ticket. Open a new ticket with a subject, first comment, priority, type, and tags.
• zendesk/update-ticket. Patch an existing ticket's status, priority, assignee, tags, or attach a comment.
• zendesk/add-ticket-comment. Post a public reply or an internal note on an existing ticket.
• zendesk/list-users. List end-users, agents, and admins, paginated by cursor.
• zendesk/create-user. Create an end-user, agent, or admin and attach them to an organization.
• zendesk/list-organizations. List organizations in the account, paginated by cursor.

Known limitations

• Rate limits follow Zendesk's per-endpoint per-minute caps documented at https://developer.zendesk.com/api-reference/introduction/rate-limits/. TaskJuice retries on 429 responses honoring the Retry-After header.
• Cursor pagination uses Zendesk's page[after] parameter; the maximum page[size] is 100 per page on the cursor-based endpoints.
• Webhook payload shape varies by trigger configuration in Zendesk. Use the JSON template field on the webhook to ensure the ticket object is present in the body so downstream steps can deref ticket fields reliably.
• OAuth client registration requires Zendesk Admin permissions. Each subdomain is a separate Zendesk account and must be connected individually.