Syncing your Zendesk help center allows you to use your existing articles to power Fin Agent and Fin Copilot.
This integration is designed to prioritize data privacy by utilizing only publicly accessible content specifically synced to Fin, ensuring customer and organizational security throughout the process.
Note: You must have access to Zendesk Guide to use this feature. Your help center will remain on Zendesk; this process only syncs the content into Fin
Important: The legacy Zendesk importer will be deprecated on 25 April. After this date, both automatic and manual syncs will stop. To keep syncing, you need to migrate to the new importer before 25 April. Go to your Zendesk source, click Manage (three dots) > Migrate importer, and follow the prompts. After migration, open the new importer and click Edit source to configure metadata filters and review your settings.
Set up sync with Zendesk help center
To set up your Zendesk help center sync, go to Train > Content and click See all.
In Connect external app content choose Zendesk articles.
Choose your authentication method, select either API Token or OAuth, then click Connect.
Enter your Zendesk subdomain (e.g.,
yoursubdomain.zendesk.com). This is the part of your Zendesk URL that comes before.zendesk.com.
Optionally toggle Sync articles for signed-in users to include content only visible to authenticated customers. Click Next when the connection is successful.
Use the Metadata tab to pre-filter which content is imported. Click + Add Filter to narrow by Categories, Labels, or Timestamps. Skip this step to import all eligible content by default.
Use the Target tab to configure where imported content is used:
Fin AI Agent: Toggle this on to use Zendesk articles for automated customer answers.
Copilot: Enable this to provide suggested answers to your teammates.
Help Center: Toggle this on to publish Zendesk content directly into your Intercom Help Center.
Audience Control: Choose which specific audiences can see this content.
Do a final check on the Review tab:
Enter a custom name for the sync to identify it in your Knowledge list (e.g., "Zendesk - Public Support").
Check the summary to see how many articles and fields are being imported.
Confirm your Available in and Audience settings are correct.
Click Sync and set live to begin.
Note:
Articles synced with "Staff" permissions are only enabled for Fin Copilot by default and won't be used by Fin Agent in answers to customers.
The first sync cannot be stopped once it has started. You can only remove the integration after the initial sync is complete.
After the first sync is complete, you’ll receive an email confirmation listing how many articles were synchronized. The content will appear in Train > Content under the "Content sources" section.
Manage sync with Zendesk help center
When your content is synced with Zendesk, it will be accessible from Train > Content under the "Content sources" section.
Configure the settings
Synced articles are view-only within Fin and cannot be edited directly in the content library. All changes to article content must be made in Zendesk. These changes will automatically be updated in Fin during the next sync.
However, you can manage settings for each article. Go to Train > Content and click on your Zendesk source under the "Content sources" section, then open the article you want to manage.
There's a "Details" panel on the right which contains:
Data: View the content type, language, creation date, last updated (date it was last synced with Zendesk).
Fin: Enable/disable for Fin Agent and Fin Copilot. When enabled, the content becomes available to customers and teammates, respectively.
Audience: Target your content at a specific audience, so Fin Agent only shares content that is relevant for them.
Tags: Add a tag to group articles together and keep content organized.
How Zendesk metadata is managed
The importer automatically brings the structure of your Zendesk knowledge base into your Fin workspace to save you time.
Zendesk metadata like labels, categories, and content tags are all imported and converted into tags on your Fin workspace. With these tags automatically applied, you can:
Filter your content to see all articles from a certain category.
Exclude irrelevant content from Fin.
Create specific Fin audiences based on article tags to route answers to the right customers.
The advanced importer further optimizes this by enabling precise filtering and configuring audience-specific content delivery through mapped tags.
Pro tip: For example, if you have content in Zendesk labeled "EMEA-only," that label becomes a tag in your Fin workspace. You can then create an audience for your European customers and configure Fin to only use articles with the "EMEA-only" tag for that audience.
Automatic Zendesk content re-syncs
Fin automatically re-syncs with your Zendesk help center every hour to pull in any changes. This includes new articles, content edits, and article deletions. You won't receive an email for these automatic syncs.
Manually re-sync or remove Zendesk content
If you need to manually trigger a re-sync or remove the Zendesk content entirely, go to Train > Content. Click the three-dot menu next to the Zendesk source and select Re-sync or Remove this source.
When removing a source, you’ll see a green confirmation banner indicating the removal has been successful and synced articles will be deleted from Fin.
Re-authenticate your Zendesk connection
If the admin who set up the Zendesk sync has left the company or no longer has the right permissions, you don't need to delete and recreate the sync. Simply re-authenticate and your existing content and reporting will not be affected.
Click Edit source on your existing Zendesk sync.
Switch to the Connect tab.
Re-authenticate using API token or OAuth.
Important: Make sure the account you use has the proper access level in Zendesk. Using an account with insufficient permissions could result in content being lost during future re-syncs.
Using synced articles with Fin
After syncing your Zendesk articles with Fin, you can use them to power the following:
AI answers
AI answers
Browsing articles in the "Help" space
Searching for articles in the "Help" space
Important differences between your articles in Zendesk and the Fin Messenger
There are slight differences with how synced articles look in the Fin Messenger compared to your Zendesk help center. Differences can include:
Content formats such as, additional headings, text styling, table formatting, etc.
If a customer clicks the “Open in Help Center” link at the bottom of a synced article in the Fin Messenger, this will open a new tab with the article in your Zendesk help center.
We exclusively support videos added through Zendesk's 'Add video' button, typically embedded via
iframe, and compatible with all providers available in Zendesk's article editor (e.g., YouTube, Vimeo, Wistia, JWPlayer, Brightcove, Vidyard, Loom, Guidde). Custom HTML, CSS, or JavaScript-based video embeds are not supported.If articles appear blank in the Fin Messenger, it could be due to your site's Content Security Policy (CSP) blocking third-party resources required for proper loading, such as external images or scripts.
FAQs
What data does Fin use when integrated with Zendesk?
What data does Fin use when integrated with Zendesk?
Fin integrates seamlessly with Zendesk to provide customer-facing answers. However, it is important to understand the specific data sources Fin utilizes to ensure both operational effectiveness and data privacy.
Content for answer generation
When integrated with Zendesk, Fin exclusively uses support content that is explicitly synced to your Fin workspace. This includes:
Public articles from the Zendesk Help Center
Other synced public content like website syncs
Uploaded documents
Snippets
Response guidance that has been configured by your team
This ensures that Fin's responses are based on verified information you have selectively enabled for Fin.
Exclusion of private data
Fin does not utilize private data from Zendesk, ensuring customer and organizational privacy. Specifically, the following data is not used by Fin when responding to customers:
Internal (private) comments within Zendesk
Historical Zendesk tickets or customer conversation data
By excluding these data sources, Fin ensures that only approved public and explicitly synced content is referenced for AI-generated answers.
Will tables from my Zendesk articles also be synced?
Will tables from my Zendesk articles also be synced?
Yes, if you have a table in your Zendesk article, it will be synced and used by Fin. You will be able to see the table synced in the content of your Fin workspace, exactly as it is in your Zendesk help center.
Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts