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 the Firmhouse Admin Dashboard
- Navigate to your Firmhouse Dashboard
2
Create your API token
- Click on Integrations in the side panel
- Click on Generate new token, choose No expiration and choose Write as your Access Type, click on Create project access token.
- Copy the token you just created, you will need it later.
3
Create a new Server-side source in Converge
- In Converge, click on Create a new source
- Pick Server-side from the modal
- Name your source: e.g.
{Storename} Subscriptions
4
Connect and configure the Source
- Choose Firmhouse as the app you want to connect.
- Enter the Firmhouse access token you created in Step 4.
-
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. -
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.
- 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.Event Name | Event Description |
---|---|
Started Subscription | When a customer starts a subscription. |
Placed Order* | When a customer places and order. |
Sales channels
More on sales channels can be found here. 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 |