Zendesk Integration Guide for DSR Automation
Overview
This guide explains how to configure and use the native Zendesk integration in TrustWorks to automate Access and Erasure Data Subject Requests. The integration removes the need for Generic API steps and handles Zendesk specifics such as ticket comments retrieval and user deletion prerequisites.
What the integration allows to do
- Access DSRs
- Retrieve a Zendesk user and user profile by email.
- Retrieve the user’s tickets.
- Retrieve comments for the user’s tickets.
- Erasure DSRs
- Close open tickets for the user so deletion is permitted by Zendesk.
- Delete the user (soft delete).
- Optional: Permanently delete the user via Zendesk’s Deleted Users endpoint.
- Optional: Permanently delete tickets if your policy requires it.
Legal and policy note: Customers must configure access and erasure behavior in line with their data retention and regulatory obligations. The examples in this guide are illustrative and must be adapted to each environment.
Table of Contents
- Prerequisites
- Set up the Zendesk integration
- Create and link the Zendesk asset
- Build the DSR workflow
- Testing and validation
- Video Walkthrough
- Operational Notes
- Troubleshooting
- Support
- Summary
Prerequisites
- TrustWorks admin access.
- Zendesk admin user with API enabled and an API token.
- Your Zendesk subdomain, admin email, and API token.
- A test Zendesk user email you can use for validation (ideally with at least one open ticket and one comment).
Set up the Zendesk integration
- In TrustWorks, go to Settings → Integrations.
- Click New Integration and select Zendesk.
- Complete the fields:
- Integration name: e.g.,
Zendesk Prod
. - Authentication method: API Key.
- Subdomain: e.g.,
yourcompany
(TrustWorks will resolveyourcompany.zendesk.com
). - Admin email: Zendesk admin email that owns the token.
- API key: Paste the Zendesk API token (in the original format, not in base64).
- Integration name: e.g.,
- Click Test connection. If successful, click Save.
Tip: Ensure the Zendesk user for the token has adequate permissions to read users, tickets, and comments, and to update or delete where required.
Create and link the Zendesk asset
- Go to Assets → New (or open an existing Zendesk asset)
- Choose Application → Third Party → Zendesk
- Assign an owner (e.g. Privacy Team)
- In Automation, select your Zendesk integration and enable it
- Save
Linking the asset to the integration is required so workflow actions can call Zendesk with the right credentials and context.
Build the DSR workflow
You can add Zendesk automation into an existing DSR workflow or create a new one.
- Go to Workflows → New Workflow
- Select Data Subject Request as the type
- Choose the trigger (e.g. when a DSR is created)
Access Request Example
- Add an ‘Access Data’ action
- Select your Zendesk asset
- Choose what to retrieve: User profile, Tickets, Comments
Erasure Request Example
- Add an ‘Erase Data’ action
- Select your Zendesk asset
- Choose what to delete:
- Close open tickets (required before deletion)
- Delete user (soft delete)
- Optionally: permanently delete user and/or tickets
Important: If you choose to keep tickets for retention, select Close open tickets and Delete user, but do not enable permanent ticket deletion. In Zendesk, closed tickets remain accessible for audit and will show “Permanently deleted user” as the requester.
Testing and validation
Follow these steps to validate end-to-end:
- Ensure the workflow toggle is set to Active and click Save.
- Create a test DSR with your Zendesk test email by going to Subject Requests → New. Choose Access or Erasure to match your workflow configuration.
- Monitor execution
- Open the DSR and go to Execution Details.
- Use Flow or List view.
- Click the eye icon on each action to view raw requests and responses where applicable.
- Verify in Zendesk
- Access: verify the user, tickets, and comments exist and match exported data.
- Erasure: verify the user is deleted. If you preserved tickets, ensure they are closed and the requester shows as “Permanently deleted user.” If you chose permanent ticket deletion, verify tickets are no longer present.
🎥 Video Walkthrough
Prefer a step-by-step demo? Watch this short video where our Solutions Engineer Moumen walks through setting up the integration, linking a Zendesk asset, and building both Access and Erasure workflows in TrustWorks:
Operational notes
- Closing vs deleting tickets: Some customers close tickets instead of deleting them to keep an audit trail. Deleting tickets removes content and may affect retention policies. Choose the option that aligns with your legal and business requirements.
- Deletion order: Zendesk will not delete a user with open or solved tickets. Tickets must be closed first. TrustWorks sequences the actions accordingly when both are selected.
- Permanent deletion: Use permanent user deletion only after the user has been soft-deleted. Use permanent ticket deletion only if your policy requires it.
Troubleshooting
Symptom | Likely cause | Resolution |
---|---|---|
Access action returns no user | Email does not match a Zendesk user | Confirm the DSR email matches the Zendesk user email exactly. |
Access shows user but no tickets | User has no requested tickets or they belong to another requester | Verify ticket requester is the same user. |
Erasure fails to delete user | User has open or solved (not closed) tickets | Enable “Close open tickets” in the Erase action, then delete the user. |
Erasure completes but tickets remain | You chose to retain tickets | This is expected when you close tickets instead of deleting them. |
Integration test fails | Invalid token, wrong subdomain, or insufficient permissions | Recheck subdomain, admin email, token validity, and role. Ensure API access is enabled in Zendesk. |
Comments missing in Access export | Comments require traversing each ticket | Ensure “Ticket comments” is selected in Zendesk data to access. The native action handles the iteration. |
If an action shows a failure, open Execution Details, click the eye icon on the action, and review the returned message for the precise cause.
Support
If you encounter issues or need implementation support:
- Contact TrustWork’s support team: support@trustworks.io
- Zendesk API Docs: developer.zendesk.com
Summary
By integrating TrustWorks with Zendesk, your organization can:
- Automate access and erasure requests for customer data
- Reduce the manual workload on support and compliance teams
- Maintain a defensible audit trail for regulators and internal stakeholders
- Deliver faster, more consistent responses to end-user privacy requests