Skip to main content

Zendesk Integration - Setup Guide

Connect your Zendesk account to Goodweek to manage support tickets, organizations, users, macros, and views directly from your AI workspace.

A
Written by Antoine Stempien

Connect your Zendesk account to Goodweek to manage support tickets, organizations, users, macros, and views directly from your AI workspace.

ℹ️ Governance note

Goodweek will never exceed the access levels granted to the user within Zendesk, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.

📋 Prerequisites

Before any user can see and connect the Zendesk integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.

Admin Setup

The Zendesk integration uses OAuth 2.0. The connecting user must have the appropriate Zendesk role to authorize third-party apps. Admin-level access is required for certain tools such as configuring triggers, automations, or custom fields.

User Connection

  1. In Goodweek, go to Integrations.

  2. Find Zendesk and click Connect.

  3. You will be prompted to enter your Zendesk subdomain (e.g. yourcompany from yourcompany.zendesk.com).

  4. You will be redirected to Zendesk, where you will be asked to sign in and authorize access.

  5. Click Allow to grant access and return to Goodweek.

Important Notes

  • Each user must connect their own account individually.

  • Goodweek can only access the tickets, organizations, and data that your individual Zendesk account has permission to see. Agent visibility restrictions apply.

  • Some tools (triggers, automations, custom fields, views) require Zendesk Admin role. Regular agents will not have access to these tools.

  • You can revoke Goodweek's access at any time from Zendesk → Admin Center → Apps and integrations → Connections → Composio → Revoke.


Available Tools

Tool

Description

Type

Create Zendesk Ticket

Creates a new support ticket in Zendesk with full support for all ticket fields.

Write

Create Many Zendesk Tickets

Creates up to 100 tickets in a single request as a background job.

Write

Get Zendesk About Me

Retrieves information about the currently authenticated Zendesk user.

Read

Show Changes to Ticket

Shows changes to a ticket that would result from applying a specific macro.

Read

Get Incremental Tickets

Retrieves tickets modified since a specified start time for incremental sync.

Read

List Deleted Tickets

Lists tickets that have been soft-deleted from Zendesk, showing up to 100 per page.

Read

Create Zendesk Request

Creates a new end-user support request through the API.

Write

Create Side Conversation

Creates a private side conversation on a Zendesk ticket for agent-to-agent communication.

Write

Upload Zendesk Attachment

Uploads a file attachment to Zendesk, returning an attachment token for use in ticket comments.

Write

Create Zendesk User

Creates a new user (agent or end-user) in Zendesk.

Write

Create Many Zendesk Users

Creates up to 100 users in a single request, handled asynchronously.

Write

Create or Update User

Creates or updates a Zendesk user based on email or external_id match.

Write

Autocomplete Users

Searches for Zendesk users by name prefix for quick user lookup.

Read

Get Incremental Users

Retrieves users modified since a specified start time for incremental sync.

Read

Create Zendesk Organization

Creates a new organization in Zendesk.

Write

Get Zendesk Organizations

Lists all organizations in Zendesk with pagination.

Read

Create or Update Organization

Creates or updates a Zendesk organization using external_id as the match key.

Write

Merge Zendesk Organizations

Merges two Zendesk organizations, combining users, tickets, and data.

Write

Create Organization Membership

Assigns a user to a Zendesk organization.

Write

Create Zendesk Group

Creates a new agent group in Zendesk.

Write

List Assignable Groups

Lists all groups that can be assigned to tickets or users.

Read

List Group Users

Lists all users belonging to a specific Zendesk group.

Read

Create Zendesk Group Membership

Assigns an agent to a Zendesk group.

Write

List Macros

Lists all shared and personal macros in the Zendesk account.

Read

Show Macro

Retrieves details of a specific macro by its ID.

Read

Apply Zendesk Macro Preview

Previews how a macro would affect a ticket without applying it.

Read

Create View

Creates a new ticket view (saved filter) in Zendesk.

Write

Preview View

Previews which tickets match a set of view conditions before saving the view.

Write

List Active Triggers

Lists all active ticket triggers in the Zendesk account.

Read

Create Trigger

Creates a new business rule trigger that acts on tickets meeting specified conditions.

Write

List Automations

Lists all automations configured in the Zendesk account.

Read

Create Automation

Creates a new automation that performs actions on tickets based on time-based conditions.

Write

List Brands

Lists all brands configured in the Zendesk account.

Read

Create Ticket Field

Creates a new custom ticket field with various field types.

Write

Create Custom Object Record

Creates a new record for a custom object type in Zendesk.

Write

Get Account Settings

Retrieves Zendesk account settings and feature configuration.

Read

Get Attachment

Retrieves details of a single Zendesk attachment by its ID.

Read

List Guide Surveys

Lists available CSAT surveys in Zendesk Guide.

Read

List Guide Survey Responses

Lists CSAT survey responses from Zendesk Guide.

Read

Delete Zendesk Ticket

Permanently deletes a ticket including its entire conversation history. This action is irreversible.

⚠️ Destructive

Delete Zendesk User

Permanently deletes a user from Zendesk. This action cannot be undone.

⚠️ Destructive

Delete Zendesk Organization

Permanently deletes an organization from Zendesk. This action is irreversible.

⚠️ Destructive

Bulk Delete Zendesk Suspended Tickets

Permanently deletes multiple suspended tickets in a single action.

⚠️ Destructive

Use Cases

  • Create and manage support tickets from conversations. Log new Zendesk tickets with the right subject, description, requester, and priority directly from a Goodweek conversation, keeping support operations in context with other work.

  • Manage users and organizations. Create or update Zendesk users and organizations, assign users to groups, and manage organization memberships from Goodweek to keep your support structure accurate.

  • Review macros and triggers before applying. Preview how macros or view conditions would affect tickets from Goodweek before committing to changes, reducing the risk of accidental misconfiguration.

  • Monitor CSAT and survey responses. Retrieve CSAT survey results and responses from Zendesk Guide within a Goodweek conversation to review customer satisfaction data without navigating the Zendesk Explore dashboard.


Troubleshooting

Some tools are not working after connecting

Certain Zendesk tools require Admin role. If you are connecting with an Agent account, admin-level tools will not be accessible. Contact your Zendesk admin to adjust your role if needed.

Integration not visible in Goodweek

Make sure your organization admin has enabled the Zendesk integration from the Goodweek Admin Panel under the Integrations tab.

References

Did this answer your question?