# Installation

### Install Birdie in Pylon 

#### 1. Get your Pylon API Token

* First, go into your Pylon workspace Settings > Integrations & dev > API Tokens.
* Create a new token with the **Admin** role, and give it a recognizable name (for example, *"Birdie Token"*).
* Copy the token and store it somewhere safe - you’ll need it in the next step.

#### 2. Setup Birdie

Go to your [**Birdie workspace settings**](https://app.birdie.so/settings/helpdesk), open the **Helpdesk Integrations** section, find **the "Pylon" integration**, and click **Enable**.

<figure><img src="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FGhGAA8B3hn0MoItgCyz8%2FScreenshot%202025-07-11%20at%2009.00.48.png?alt=media&#x26;token=d4e9c3bb-1e7d-4aa9-b23b-9aa2c914bedd" alt=""><figcaption></figcaption></figure>

A window will open prompting you to paste the API token you just created. Paste it into the **API Token** field and click the **Test** button.

![](https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FWR4ufauGAOfAmcS2bqzC%2FScreenshot%202026-02-18%20at%2016.13.29.png?alt=media\&token=5b39cc9a-08be-4722-a9b8-065bd948ab40)

If the token is valid, you will see three pieces of information required to complete the Pylon integration in the next step.

Make sure to click **Save** before leaving.

#### 3. Setup Pylon Integration

Go back to your **Pylon workspace** → **Settings** → **Integrations & Dev** → **Integrations**.

Scroll down to **Custom Iframe (by Pylon)** and click on it.

On the Iframe Integration screen, click **+ Add Iframe**, then fill out the form with the following information:

* <mark style="color:$info;">Display location:</mark> choose the value **Issue Sidebar**
* <mark style="color:$info;">Title:</mark> Birdie Screen Recording&#x20;
* <mark style="color:$info;">Description (optional):</mark> *leave empty*
* <mark style="color:$info;">Icon URL (optional):</mark> <https://app.birdie.so/img/birdie-logo.svg>
* <mark style="color:$info;">URL:</mark> copy the URL directly from the Pylon Setup window in Birdie (see previous step).
* <mark style="color:$info;">Height (in pixels, optional):</mark> *leave empty*

Make sure to click **Save**.

You're all set! The **Birdie Screen Recording** panel should now appear in your Issue sidebar.&#x20;