> 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

How to install Birdie on Helpscout

**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="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FaK7MAvnKD3HdSQl14UlV%2Fhelpscout%20installation.png?alt=media&amp;token=9d8d347f-7bcf-4fbf-811d-2fc82153b4db" 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="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FHfStMSmofDkC6q8PXhzL%2Fhelpscout%20installation%202.png?alt=media&amp;token=6331cd0a-0a1f-40cb-b108-9541ab8bf390" 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="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FA5bBchdpHJQaR5IY6yov%2Fhelpscout%20installation%203.png?alt=media&amp;token=0936ecd8-0722-4fbb-8bf4-d65659c012e7" 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>