# Whistl (prebuilt connector)

## Description

**Whistl** is the UK's leading logistics company, specialising in fulfilment, contact centres, mail and parcel delivery management.

## API documentation

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

{% embed url="<https://app.swaggerhub.com/apis-docs/whistl/whistl-api_for_wms_integration/2.0.11#/>" %}

## Authentication&#x20;

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

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

### 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>Scope</code></td><td>true</td><td>Set to <code>public</code>.</td></tr><tr><td><code>Client ID</code></td><td>true</td><td>Your client id for the  Patchworks integration.</td></tr><tr><td><code>Client secret</code></td><td>true</td><td>Your client secret for the  Patchworks integration.</td></tr><tr><td><code>Environment</code></td><td>true</td><td>Your Whistl environment.</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>

### Token authentication

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 **token** authentication, the credentials below are prompted:

<table><thead><tr><th>Credential</th><th width="145" data-type="checkbox">Required?</th><th>Notes</th></tr></thead><tbody><tr><td><code>token</code></td><td>true</td><td>Enter the token provided for this integration.</td></tr><tr><td><code>Environment</code></td><td>true</td><td>Enter the required environment.</td></tr></tbody></table>