> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Firmhouse
> Connect your Firmhouse subscription events to Converge
export const OutboundLink = ({linkText, linkTarget}) => {
return {linkText}
;
};
## Installation instructions
Firmhouse is primarily used as a subscription backend and checkout that is run in parallel with an ecommerce platform such as Shopify, but some merchants choose to run Firmhouse standalone without a shopping backend.
Your Converge configuration will depend on your specific Firmhouse setup.
1. Navigate to your
2. Click on **Integrations** in the side panel
3. Click on **Generate new token**, choose **No expiration** and choose **Write** as your Access Type, click on **Create project access token**.
4. Copy the token you just created, you will need it later.
5. In Converge, click on **Create a new source**
6. Pick *Server-side* from the modal
7. Name your source: e.g. `{Storename} Subscriptions`
8. Choose **Firmhouse** as the app you want to connect.
9. Enter the Firmhouse access token you created in *Step 4*.
10. Review the options and pick how the subscription value of the `Started Subscription` event in Converge should be calculated. If you are unsure, ask your contact at Firmhouse for a recommendation.
11. The next step depends on whether you are running Firmhouse side-by-side Shopify, or standalone.
Choose **Shopify** as your **Product and variant ID** and make sure **Track Firmhouse invoices as Placed Order events** is turned **off**.
Choose **Firmhouse** as your **Product and variant ID** and make sure **Track Firmhouse invoices as Placed Order events** is turned **on**.
12. You can ignore shipment date and leave Start Date blank and click on **Create Source**.
***
## Event spec
This integration auto-tracks the following events on the server with all properties available according to the [Converge event spec](/sources/converge-spec).
| Event Name | Event Description |
| ------------------------------------------------------------------- | -------------------------------------- |
| [Started Subscription](/sources/converge-spec#started-subscription) | When a customer starts a subscription. |
| [Placed Order](/sources/converge-spec#started-subscription)\* | When a customer places and order. |
\*Only when configured in the Source configuration.
### Sales channels
More on sales channels can be found [here](/sources/concepts/sales-channels).
An example of how Converge map Firmhouse events:
| Firmhouse | Converge Mapping | Description |
| --------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Started Subscription | web | New subscription triggered |
| Placed Order | web or subscription\_contract | Recurring placed order events are mapped to "subscription\_contract" while first time and one time purchases are mapped to "web" |
| Placed Shipment Order | offline | Placed shipment orders |
3. Click on **Generate new token**, choose **No expiration** and choose **Write** as your Access Type, click on **Create project access token**.
4. Copy the token you just created, you will need it later.
11. The next step depends on whether you are running Firmhouse side-by-side Shopify, or standalone.
