Instances represent a single business in Teal; you can also think of them as a “set of books” for your users.
Use the Create Instance endpoint and set their
Remember to store the association between an instance in Teal and their associated entity in your product.
An accounting package (the
gl_backend parameter) is required for every Instance as it defines the source of truth for a set of books and what features a customer has access to. There are two accounting package options:
platform_gl: Our build-your-own solution allows you to build your own bespoke accounting software to fit your users unique needs. A chart of accounts template is required for all
quickbooks: Integrate a customer’s existing QuickBooks account. Please note that not all features are available for Instances using QuickBooks as their accounting package.
We plan on integrating with more popular accounting packages soon. If you have a specific accounting package you’d like an integration for, please reach out to us.
Subscription tiers unlock reporting and advanced features for your users. By default, Instances have a
tier 0 subscription and can be upgraded to higher tiers using the Update Subscription endpoint.
|Basic reports, line entry categories
|Filter reports using tags
Contact us for Instance tier pricing levels. Instances in Sandbox environments are always free.
entries_start parameter is the start date from which the API will sync an instance’s accounting data. Transactions or journal entries cannot be entered before the start date, but you will be able to read reports.
You will generally set a start date that is the beginning of the financial year that your instances will begin tracking their books on your platform, or the start date of their business, whichever is sooner.
You can use the Opening Balances endpoint to set their balance sheet properly so that it is accurate on the start date. (PlatformGL only).
Chart of accounts (PlatformGL only)
A chart of accounts template (the
coa_template_id parameter) is required for all new PlatformGL instances to generate their ledgers. You can view and manage your templates in the Developer Portal or using the Chart of Account Template endpoints.