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.
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.
-
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 |
Was this page helpful?