> 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/plain/installation.md).

# Installation

### Install Birdie in Plain 

#### 1. Get your Plain API Key

* First, go into your Plain workspace Settings > Machine users & API Keys.
* Create a new Machine User dedicated to Birdie.
* Create an API Key for this user, and add 6 permissions:
  1. <mark style="color:$danger;">`chat:create`</mark>
  2. <mark style="color:$danger;">`customer:read`</mark>
  3. <mark style="color:$danger;">`thread:read`</mark>
  4. <mark style="color:$danger;">`thread:reply`</mark>
  5. <mark style="color:$danger;">`user:read`</mark>
  6. <mark style="color:$danger;">`workspace:read`</mark>
* Copy the API Key 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 "Plain" integration**, and click **Enable**.

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

<div align="left"><figure><img src="/files/JF8eQz4cjbeQdBKG7eZe" alt=""><figcaption></figcaption></figure></div>

The API Key and permissions will be tested. If valid, click on **Save**.

You're all set! You can now [add the Birdie Snippet](/birdie-docs/helpdesk/plain/flows/human-initiated-requests-via-snippet.md) to request recordings from your users.