> 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/hubspot/flows/forms.md).

# Forms

How to add Birdie to your HubSpot ticket form

To allow customers to submit tickets with screen recordings, you need to add Birdie to your HubSpot form. Here is how it looks in a very simplistic way:&#x20;

<figure><img src="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FpBufBQHq7R1NXRipUexp%2FScreenshot%202025-06-23%20at%2017.15.56.png?alt=media&amp;token=794964a2-4d9b-4ab9-865f-ee538948b425" alt=""><figcaption><p>Birdie on your HubSpot Form - End User's View</p></figcaption></figure>

### **How to Set It Up**

1. **Go to your HubSpot Forms**\
   Open [HubSpot](https://app.hubspot.com/) and go to **Marketing > Forms.**\
   Pick a form to edit or create a new one.
2. **Add a Birdie Request Link**\
   Add a **single line text field** to your form and include your Birdie link there.\
   For example: *`Click here to record your issue.`*
3. **Get Your Birdie Link**\
   In Birdie, go to [`Settings > Helpdesk`](https://app.birdie.so/settings/helpdesk) and copy your **HubSpot Request Link**.\
   Paste that link into the HubSpot field you just added.
4. **(Optional) Personalize the Link**\
   If your users are already logged in or their email is known, you can add it to the link with HubSpot tokens:<mark style="color:purple;">`{{contact.email}}`</mark>\
   For example: `https://your-birdie-subdomain.birdie.so/urec/hubspot?email=`<mark style="color:purple;">`{{contact.email}}`</mark>\
   This way, Birdie will automatically link the recording to the right user

<figure><img src="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FbDtu4khK46WItucOwc0q%2FScreenshot%202025-06-23%20at%2017.23.49.png?alt=media&amp;token=851e5e5e-c3ce-4b80-9e41-e5124f87edee" alt=""><figcaption><p>Birdie on your HubSpot Form - End User's View</p></figcaption></figure>
