Setting up the Zendesk Federated Search API

The Federated Search external content API is a REST API that lets you ingest records of your external content into the Zendesk search indexes. This method requires that your developers build and maintain a middleware layer to integrate the service, website, LMS, blog, etc. that host the external content and the help center.

To set up Federated search without developer assistance, use the external content search crawler. See About Zendesk Federated Search.

Note: If you set up your help centers before September 25, 2019, and you have custom themes, you need to modify your themes to display search results from multiple help centers.

Configure Federated search using the external content API

Use the following process flow steps as a guide to setting up Federated search in your help center using the external content API.

1. Build your own integration with the Zendesk REST API then ingest the content you want to show up in your search results. See Federated Search API Reference.

2. Select the content that you want to include and exclude in help center search results. See Including external content in your help center search results.

3. Set up your help center theme for Federated Search.

   For external content to show up in search results in your help center search, you must have a theme that supports Federated search results. To do this, use the latest version of the Copenhagen theme or replace the old {{help_center_filters}} and {{filters}} helpers with the new {{source_filters}} and {{type_filters}} helpers (see the Help Center templating cookbook).

4. If desired, configure Knowledge results to include external content in Knowledge searches. See Configuring the context panel in the Zendesk Agent Workspace.