# Fredhopper by Crownpeak (prebuilt connector)

## Description

**Fredhopper** is a Crownpeak product discovery platform that helps retailers and brands improve how customers find, discover, and interact with products online.

## API documentation

API documentation for *Fredhopper* (used to build this connector) can be found via the link below:

{% embed url="<https://crownpeak.gitbook.io/developer-documentation>" %}

## Authentication&#x20;

When adding connector instances for *Fredhopper*, the following authentication methods are supported:

* [OAuth 2 (client credentials)](#oauth-2-authorisation-code)

### OAuth 2 (client credentials)

When a user chooses to [add a connector instance](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance) using **OAuth 2 (client credentials)** authentication, the credentials below are prompted:

<table><thead><tr><th>Credential</th><th data-type="checkbox">Required?</th><th>Notes</th></tr></thead><tbody><tr><td><code>Tenant</code></td><td>true</td><td>Your username as provided by your Fredhopper Technical Consultant.</td></tr><tr><td><code>Environment</code></td><td>true</td><td>Your Fredhopper instance - for example: <code>live1</code>, <code>test1</code>, <code>test2</code></td></tr><tr><td><code>Scope</code></td><td>true</td><td>The required scope to define what access permissions should be given to Patchworks. Typically set to <code>openid</code>.</td></tr><tr><td><code>Client ID</code></td><td>true</td><td>The <code>client id</code> for your Fredhopper service account. For details please see Crownpeak's API documentation: <a href="https://crownpeak.gitbook.io/developer-documentation/item-catalog-management/authorization-to-apis">Authorization to APIs</a>.</td></tr><tr><td><code>Client Secret</code></td><td>true</td><td>The <code>client secret</code> for your Fredhopper service account. For details please see Crownpeak's API documentation: <a href="https://crownpeak.gitbook.io/developer-documentation/item-catalog-management/authorization-to-apis">Authorization to APIs</a>.</td></tr><tr><td><code>Grant type</code></td><td>true</td><td>Set to <code>client_credentials</code>.</td></tr><tr><td><code>Response authentication token key</code></td><td>true</td><td>Set to <code>access_token.</code></td></tr></tbody></table>