Codat concepts

Understand key terms and definitions used in Codat's solutions

Throughout this documentation, you will come across a number of core concepts and terms used throughout our Products:



Next Steps


A company represents an SMB user who has granted you access to view a subset of their accounting, commerce, or banking data—referred to as their consented data.

Each company has one or more data connections that connect the company to a Codat integration for accounting, commerce or banking.

Read more about Companies

Follow our guide to creating your first Company


A data connection represents the connection between a company and one of their sources of business data, such as an accounting platform or payments system.

Each data connection is unique to a specified Codat integration.

Data connections have a current state; a linkUrl to allow SMB customers to authorize or reauthorize the data connection; and other metadata, such as the last refresh date.

When creating them, integration-specific connection information, such as access tokens to allow for migrations into Codat can be provided.

Read more about Data Connections

Follow our guide to creating your first Company


An integration is a connection to an external source of business data in an accounting, commerce or banking app or platform that's used by an SMB.

For example, the Xero, Shopify, and Plaid integrations provide connections to those respective platforms.

Integrations are designed, built and maintained by Codat, and updated periodically to accommodate changes to the source data and provider APIs.

Integrations have a sourceType that describes the type of data they provide: either Accounting, Commerce (sales data), or Banking.

Read more about Integrations

Configure your Accounting Integrations

Configure your Banking Integrations

Configure your Accounting Integrations

Sync Settings

Codat allows you to configure the types of data and frequency you update the data from data connections

Configuring your Sync Settings


Codat allows you to receive notifications by webhook or email for a number of events, such as when a Company has refreshed their data or a Data Connection has become deauthorized so you can take the appropriate action.

Setup and Configure your Alerts


Codat allows you to add users to your instance, with different roles and permissions; and also to manage Single Sign On with Google or Microsoft.

Read more about administrating users on your Codat instance

Data Status

When looking at the status of a refresh of data in the Codat Portal, you may see datasets in various states, such as Completed, Queued or AuthError.

Read more about the possible statuses and what they mean