# 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](/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance.md) 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/fredhopper-by-crownpeak-prebuilt-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.