> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refold.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> Connect to your Help Scout app for OAuth.

To setup your Help Scout app in Refold for OAuth, you will need the following credentials from your [Help Scout account](https://secure.helpscout.net/):

* Client ID
* Client Secret

### Pre-requisites

1. Help Scout account. You can create one [here](https://secure.helpscout.net/members/register/41/).

<Info>If you haven't already created an app in Help Scout, you'd need to create one.</Info>

### Creating an app in Help Scout

To create a Help Scout app and acquire the above mentioned credentials, please follow the steps mentioned below:

1. Log in to your [Help Scout account](https://secure.helpscout.net/).
2. Click on the `Profile` icon in the top right, select `Your Profile` option and go to `My Apps`.

<img height="200" src="https://mintcdn.com/cobalt-55/lcADCqUGrbz-iIZQ/images/Helpscout/helpscout_navigation.png?fit=max&auto=format&n=lcADCqUGrbz-iIZQ&q=85&s=a0955cfb996dd522228466694468e0a4" alt="Navigation for App setup" data-path="images/Helpscout/helpscout_navigation.png" />

3. Go to your [`Apps catalog`](https://app.gocobalt.io/apps) in **Refold** > Search for `HelpScout` > `Settings` > `Use your credentials` > `Callback Url` > Copy it.
4. Click on `Create My App` button > Enter the App Name > Paste the Callback Url under `Redirection URL` field and click on `Create`.
5. Copy the **App ID** and **App Secret** from the `Credentials` section.

<img height="200" src="https://mintcdn.com/cobalt-55/lcADCqUGrbz-iIZQ/images/Helpscout/helpscout_credentials.png?fit=max&auto=format&n=lcADCqUGrbz-iIZQ&q=85&s=9ea1ab3119093da2985df92cd1f8b267" alt="Getting Credentials" data-path="images/Helpscout/helpscout_credentials.png" />

#### Configuring credentials in Refold

App settings page lets you configure the authentication settings for an `OAuth 2.0` based application. For your customers to provide you authorization to access their data,
they would first need to install your application. This page lets you set up your application credentials.

<img height="200" src="https://mintcdn.com/cobalt-55/lcADCqUGrbz-iIZQ/images/Helpscout/helpscout_cobalt.png?fit=max&auto=format&n=lcADCqUGrbz-iIZQ&q=85&s=3fa60553b5ff6c31492518de93a12b42" alt="Setting up application client credentials" data-path="images/Helpscout/helpscout_cobalt.png" />

Provide the acquired Client ID and Client Secret under Settings of the app and save it.

#### Help Scout Single Webhook URL

If you wish to create an orchestration where a workflow is being triggered when some operation occurs in Help Scout, you'd need to subscribe to Help Scout's Webhook. Refold provides
a single webhook URL to manage such event triggers for all your customers.

**To setup Help Scout webhook subscription:**

1. Select **HelpScout** from the application list in **Refold**, and select `Settings`.
2. Copy the `Single Webhook Url`
3. Go to `Manage` in the top nav bar > Select `Apps` > `Webhooks` in your Help Scout account.
4. Click on `Install App`
5. Provide the `Secret Key` as \*\* \*\* > Paste the **Single Webhook Url** in `Callback URL` > Toggle on for **Active** > Select the Events and click on `Save`.

<Note>
  Ensure that the Secret key entered is \`\`. No other value will be able to verify the Webhook.
</Note>

<img height="200" src="https://mintcdn.com/cobalt-55/lcADCqUGrbz-iIZQ/images/Helpscout/helpscout_webhook.png?fit=max&auto=format&n=lcADCqUGrbz-iIZQ&q=85&s=e1ae48246f4456c4da0678d63aadecf8" alt="Setting up Help Scout Webhook URL" data-path="images/Helpscout/helpscout_webhook.png" />

#### Actions and triggers

Once the above setup is completed, you can create orchestrations of your use-cases using Help Scout actions and triggers. Following are the set of Help Scout actions and triggers
supported by Refold.

<Tabs>
  <Tab title="Actions">
    <AccordionGroup>
      <Accordion title="Conversation">
        1. **Create Conversation** - Create a conversation in Help Scout.
        2. **Reply To Conversation** - Reply to a conversation in Help Scout.
        3. **Add Note To Conversation** - Add a note to a conversation in Help Scout.
      </Accordion>

      <Accordion title="Customer">
        4. **Create Customer** - Create a customer in Help Scout.
        5. **Get Customer By Id** - Get a customer by ID in Help Scout.
        6. **Update Customer** - Update a customer in Help Scout.
      </Accordion>

      <Accordion title="User">
        7. **List Users** - List all users in Help Scout.
        8. **Delete User** - Delete a user in Help Scout.
      </Accordion>

      <Accordion title="Others">
        9. **HTTP Request** - Make HTTP API calls to any Help Scout documented REST APIs.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Triggers">
    1. **Conversation object changed** - Triggers when a conversation object is changed on Help Scout.
    2. **Customer object changed** - Triggers when a customer object is changed on Help Scout.
  </Tab>
</Tabs>