Get started overview
Send Taxbit your account owners, accounts, and transactions or form data through the API. Taxbit generates the tax forms. You review and approve them in the Dashboard, then deliver recipient copies in your app.
Before you start
You need four things before your first API call. Your implementation manager covers them in your Integration Planning Session, and the Help Center covers the Dashboard side.
- Access to the Taxbit Dashboard. Taxbit sets up a sandbox organization and a production organization for you and adds your first users. After that, you add users yourself. Each organization has its own credentials and data. Test in your sandbox covers how the two differ.
- API credentials. Your Organization ID,
client_id, andclient_secretare on the Developer Settings page (Settings > Developer Settings). The API calls an organization a tenant, sotenant_idis your Organization ID. Store the secret in your secret manager, never in source control or client code. You can't rotate credentials from Developer Settings. If one is exposed, ask your implementation manager, or Taxbit Support after go-live, to rotate it. - A filer. A filer is the legal entity responsible for information reporting and filing. You need one per filing entity. Set it up in the Dashboard under Settings > Filer Setup. See Filer Setup in the Help Center. You can't create account owners or accounts until your organization has a filer marked as the default. To automate it,
POST /v1/filerscreates the same record. - A server-side environment. Your backend requests and uses the tokens. Apart from the React SDK, nothing in these guides runs in a browser. The SDK gets a short-lived account owner token from your backend, never your credentials.
In your Integration Planning Session, you also decide with your implementation manager how the activity on your platform maps to Taxbit's transaction types. The Transactions reference lists every type. If you send crypto or precious-metal transactions, you also decide which assets to configure. See Configure your assets.
Your integration path
- Authenticate: get a tenant-scoped bearer token from your backend with
POST /v1/oauth/token. It's valid for 24 hours. - Create account owners and accounts: create an account owner for each of your customers, and an account for their activity, as they onboard.
- Transactions or form data: send transactions and Taxbit calculates the form amounts, or send form data with the amounts you've already calculated.
- Test in your sandbox: test the full flow in your sandbox organization.
- Go live: point the same code at production, backfill historical data, usually by CSV on the Ingest page, and run your first tax season.
To collect tax documentation in your app (W-9s, W-8s, seller data, and self-certifications), use the Tax Documentation React SDK. To deliver recipient copies in your app, see Retrieve US tax forms or Retrieve DAC7 and MRDP recipient copies. Each product section says which of these apply to you: US Information Reporting, Cost Basis, MRDP & DAC7 Reporting, and CARF & DAC8 Reporting.
Account owners and accounts
An account owner is your customer: the person or business whose tax data you collect. An account holds that account owner's transactions. Tax documentation goes on the account owner, and transactions go on the account. Both must exist before you send transactions. See the Account Owners and Accounts reference.
Create the account owner before you mount the SDKThe SDK authenticates with an account owner token, which your backend requests with
POST /v1/oauth/account-owner-tokenusing the account owner's ID. The token lasts one hour. The account owner must already exist when the SDK loads, or the SDK can't load that account owner's questionnaire. Create the account owner from your backend during signup, not when the account owner opens the form. This is the most common cause of a questionnaire that fails to load.
Questions
During implementation, contact your implementation manager. After go-live, contact Taxbit Support through Taxbit Assist in the bottom-left corner of the Dashboard, or the submission form on Contacting Taxbit Customer Support. The FAQ has short answers to the questions customers ask most.
Updated 3 days ago
