Guides
Developer guides
Practical examples for using Firmhouse APIs, Liquid, and webhooks with external e-commerce builds.
API integrations are available on the Advanced plan or higher.
Headless, Magento, Salesforce Commerce Cloud
Guides for connecting external e-commerce platforms and customer account experiences to Firmhouse.
Log customers into the Self Service Center with a token
Generate a Self Service Center login token by email address and redirect customers into their portal session.
Build a paid plan switch or upgrade flow
Let customers switch plans only after accepting an offer and completing an initial payment.
Activate with a recalculated billing date
Activate delayed subscriptions through the GraphQL API and recalculate the plan billing date from activation.
GraphQL API
Guides for working with Firmhouse data through the GraphQL API. For large exports that would otherwise run into query complexity or timeout limits, use GraphQL bulk operations.
Run large queries with bulk operations
Start an asynchronous GraphQL query, track its status, and download connection results as JSONL.
Replace subscription products in one request
Swap several products together while keeping quantities and custom prices, with guidance on shipment cadence.
Trace payment and invoice history
Reconcile payment retries, chargeback timestamps, and Shopify invoice line attributes.
Automation and webhooks
Guides for reacting to Firmhouse events and keeping external workflows in sync with subscription activity.
Send bespoke subscription messages
Send purpose-specific Liquid messages through your project’s configured email or Klaviyo channel.
Update discount amounts on each order
Use webhooks and GraphQL to increase a subscription discount after each confirmed order.
React and Next.js storefronts
Guides for building custom storefronts on top of Firmhouse using JavaScript frameworks and the GraphQL API.