> For the complete documentation index, see [llms.txt](https://docs.birdie.so/birdie-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.birdie.so/birdie-docs/helpdesk/help-scout/installation.md).

# Installation

**Step 1:** Go to [settings -> helpdesk](https://app.birdie.so/settings/helpdesk#helpscout), and click on <mark style="color:green;">`connect`</mark> HelpScout.

**Step 2:** Navigate to the [Create Custom App page](https://secure.helpscout.net/apps/create/) in Helpscout, then click on <mark style="color:green;">`Create App`</mark>.

**Step 3:** Paste the Callback URL to the Birdie App URL: <mark style="color:green;">`https://app.birdie.so/helpscout`</mark>

**Step 4:** Paste your Secret Key (you'll find it on [settings -> helpdesk](https://app.birdie.so/settings/helpdesk#helpscout))

**Step 5:** Select the Mailboxes in which you want to use Birdie, and Save.

**Step 6:** Once installed, <mark style="color:green;">`Sign in`</mark> to your Birdie workspace from the Birdie app. Make sure to use your professional email.

<figure><img src="/files/mWO9dVydJRlMctMnQhal" alt=""><figcaption><p>Step 1: Go to <a href="https://app.birdie.so/settings/helpdesk">settings -> helpdesk</a>, and click on <mark style="color:green;"><code>connect</code></mark> HelpScout</p></figcaption></figure>

<figure><img src="/files/7JBK8PzezXUIQ6ocDJiL" alt=""><figcaption><p>Steps 3, 4 &#x26; 5: Paste you callback URL, Paste your Secret Key and select your Mailboxes</p></figcaption></figure>

<figure><img src="/files/2KqtzJpedDEFgxV9DadH" alt=""><figcaption><p>Step 6: <mark style="color:green;"><code>Sign in</code></mark> to your Birdie workspace from the Birdie app</p></figcaption></figure>

<details>

<summary>What happens if IP restrictions are enabled?</summary>

Just allow the following IPs: <mark style="color:green;">`18.189.92.93`</mark> and <mark style="color:green;">`3.20.198.186`</mark>&#x20;

</details>