Firmhouse
Connect your Firmhouse subscription events to Converge
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.
Navigate to the Firmhouse Admin Dashboard
- Navigate to your Firmhouse Dashboard
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.
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
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. |
*Only when configured in the Source configuration.
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 |