Configuring QuickBooks as a Source
In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the QuickBooks option from the list of connectors. Click Next and you’ll be prompted to add your access.1. Add account access
QuickBooks uses managed OAuth2, so you do not need to create an app or copy any credentials. Click the Authorization button and sign in with your Intuit account, then choose the company you want Nekt to access. Nekt reads your data through the Accounting API — the connector only issues read queries and cannot modify anything in QuickBooks. The following configurations are available:- Start date: The earliest date from which records will be synced. Records created or updated after this date will be extracted.
- Use sandbox: (Default:
false) When enabled, the connector targets the QuickBooks sandbox API instead of production. Leave this off for real company data. - API minor version: The QuickBooks Accounting API minor version to request. Leave empty to use the connector default.
2. Select streams
Choose which data streams you want to sync. For faster extractions, select only the streams that are relevant to your analysis. You can select entire groups of streams or pick specific ones.Tip: The stream can be found more easily by typing its name.Select the streams and click Next.
3. Configure data streams
Customize how you want your data to appear in your catalog. Select the desired layer where the data will be placed, a folder to organize it inside the layer, a name for each table (which will effectively contain the fetched data) and the type of sync.- Layer: choose between the existing layers on your catalog. This is where you will find your new extracted tables as the extraction runs successfully.
- Folder: a folder can be created inside the selected layer to group all tables being created from this new data source.
- Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix to all tables at once and make this process faster!
- Sync Type: you can choose between INCREMENTAL and FULL_TABLE.
- Incremental: every time the extraction happens, we’ll get only the new data - which is good if, for example, you want to keep every record ever fetched.
- Full table: every time the extraction happens, we’ll get the current state of the data - which is good if, for example, you don’t want to have deleted data in your catalog.
4. Configure data source
Describe your data source for easy identification within your organization, not exceeding 140 characters. To define your Trigger, consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times). Optionally, you can define some additional settings:- Configure Delta Log Retention and determine for how long we should store old states of this table as it gets updated. Read more about this resource here.
- Determine when to execute an Additional Full Sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.
5. Check your new source
You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.Incremental extraction
Every entity is queried through the QuickBooks/query endpoint (SELECT * FROM <Entity> ...), paginated with STARTPOSITION/MAXRESULTS. Most streams are extracted incrementally: the connector tracks the last value of last_updated_time (lifted from the entity’s MetaData.LastUpdatedTime) and, on the next run, filters the query with WHERE Metadata.LastUpdatedTime > ... so only records changed after that point are fetched.
The company_info stream is a singleton and is always synced as full table.
QuickBooks does not return deleted transactions through the query endpoint, so hard-deleted records will not be removed from incremental tables. Schedule an occasional Additional Full Sync if you need to reconcile deletions.
Reference fields (such as
customer_ref, vendor_ref, and account_ref), addresses (bill_addr, ship_addr), line items (line), and other nested structures are delivered as JSON-encoded strings rather than native nested objects. To work with their contents, parse the string downstream (for example with JSON_PARSE/JSON_EXTRACT on AWS or JSON_VALUE/JSON_QUERY on GCP). These fields are noted as “JSON string” in the stream descriptions below.Streams and Fields
Below you’ll find all available data streams from QuickBooks and their corresponding fields. Each accordion lists the stream’s primary key, its sync behavior, and all fields. Every stream shares a common set of fields:id (primary key), sync_token, meta_data (JSON string), create_time, last_updated_time (replication key), domain, and sparse.
accounts
accounts
The chart of accounts. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive accounts.name- Account namefully_qualified_name- Fully qualified name including parent hierarchyactive- Whether the account is activeclassification- Account classification (Asset, Liability, Equity, Revenue, Expense)account_type- Account typeaccount_sub_type- Account sub-typeacct_num- Account numberdescription- Account descriptioncurrent_balance- Current balancecurrent_balance_with_sub_accounts- Current balance including sub-accountscurrency_ref- Currency reference (JSON string)sub_account- Whether this is a sub-accountparent_ref- Parent account reference (JSON string)tax_code_ref- Default tax code reference (JSON string)account_alias- Account alias
bill_payments
bill_payments
Payments made against vendor bills. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datevendor_ref- Vendor reference (JSON string)pay_type- Payment type (Check or CreditCard)total_amt- Total amountline- Bill payment lines (JSON string)check_payment- Check payment details (JSON string)credit_card_payment- Credit card payment details (JSON string)ap_account_ref- Accounts payable account reference (JSON string)bank_account_ref- Bank account reference (JSON string)cc_account_ref- Credit card account reference (JSON string)currency_ref- Currency reference (JSON string)exchange_rate- Currency exchange ratedepartment_ref- Department reference (JSON string)private_note- Private noteprocess_bill_payment- Whether the payment is processed electronically
bills
bills
Vendor bills (accounts payable). Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datedue_date- Due datevendor_ref- Vendor reference (JSON string)vendor_addr- Vendor address (JSON string)ap_account_ref- Accounts payable account reference (JSON string)sales_term_ref- Sales term reference (JSON string)line- Bill lines (JSON string)txn_tax_detail- Transaction tax detail (JSON string)total_amt- Total amountbalance- Outstanding balancecurrency_ref- Currency reference (JSON string)exchange_rate- Currency exchange ratedepartment_ref- Department reference (JSON string)private_note- Private notelinked_txn- Linked transactions (JSON string)global_tax_calculation- Global tax calculation mode
classes
classes
Classes used to categorize transactions. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive classes.name- Class namefully_qualified_name- Fully qualified name including parent hierarchyactive- Whether the class is activesub_class- Whether this is a sub-classparent_ref- Parent class reference (JSON string)
company_info
company_info
The company profile and preferences. Primary key:
id. Sync: Full table.company_name- Company namelegal_name- Legal namecompany_addr- Company address (JSON string)customer_communication_addr- Customer communication address (JSON string)legal_addr- Legal address (JSON string)customer_communication_email_addr- Customer communication email (JSON string)primary_phone- Primary phone (JSON string)company_start_date- Company start datefiscal_year_start_month- Fiscal year start monthcountry- Countryemail- Company email (JSON string)web_addr- Website address (JSON string)employer_id- Employer identification numberdefault_time_zone- Default time zonesupported_languages- Supported languagesname_value- Additional name/value metadata (JSON string)
credit_memos
credit_memos
Credit memos issued to customers. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datecustomer_ref- Customer reference (JSON string)customer_memo- Customer memo (JSON string)bill_addr- Billing address (JSON string)ship_addr- Shipping address (JSON string)line- Credit memo lines (JSON string)txn_tax_detail- Transaction tax detail (JSON string)total_amt- Total amountbalance- Outstanding balanceremaining_credit- Remaining creditapply_tax_after_discount- Whether tax is applied after discountprint_status- Print statusemail_status- Email statusbill_email- Billing email (JSON string)currency_ref- Currency reference (JSON string)exchange_rate- Currency exchange rateclass_ref- Class reference (JSON string)department_ref- Department reference (JSON string)private_note- Private notecustom_field- Custom fields (JSON string)global_tax_calculation- Global tax calculation mode
customers
customers
Customers, jobs, and sub-customers. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive customers.display_name- Display nametitle- Titlegiven_name- First namemiddle_name- Middle namefamily_name- Last namesuffix- Name suffixcompany_name- Company namefully_qualified_name- Fully qualified name including parent hierarchyprint_on_check_name- Name to print on checksactive- Whether the customer is activeprimary_email_addr- Primary email address (JSON string)primary_phone- Primary phone (JSON string)mobile- Mobile phone (JSON string)fax- Fax (JSON string)web_addr- Website address (JSON string)bill_addr- Billing address (JSON string)ship_addr- Shipping address (JSON string)notes- Notesbalance- Outstanding balancebalance_with_jobs- Balance including sub-customers/jobscurrency_ref- Currency reference (JSON string)preferred_delivery_method- Preferred delivery methodtaxable- Whether the customer is taxabledefault_tax_code_ref- Default tax code reference (JSON string)sales_term_ref- Sales term reference (JSON string)payment_method_ref- Payment method reference (JSON string)resale_num- Resale numberjob- Whether this record is a jobis_project- Whether this record is a projectbill_with_parent- Whether billed with the parent customerparent_ref- Parent customer reference (JSON string)level- Hierarchy levelv4_id_pseudonym- Internal QuickBooks identifier
departments
departments
Departments or locations used to categorize transactions. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive departments.name- Department namefully_qualified_name- Fully qualified name including parent hierarchyactive- Whether the department is activesub_department- Whether this is a sub-departmentparent_ref- Parent department reference (JSON string)
deposits
deposits
Bank deposits. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datedeposit_to_account_ref- Account the funds are deposited to (JSON string)line- Deposit lines (JSON string)cash_back- Cash back detail (JSON string)txn_tax_detail- Transaction tax detail (JSON string)total_amt- Total amounthome_total_amt- Total amount in home currencycurrency_ref- Currency reference (JSON string)exchange_rate- Currency exchange ratedepartment_ref- Department reference (JSON string)private_note- Private noteglobal_tax_calculation- Global tax calculation mode
employees
employees
Employees. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive employees.display_name- Display nametitle- Titlegiven_name- First namemiddle_name- Middle namefamily_name- Last namesuffix- Name suffixprint_on_check_name- Name to print on checksactive- Whether the employee is activeprimary_email_addr- Primary email address (JSON string)primary_phone- Primary phone (JSON string)mobile- Mobile phone (JSON string)primary_addr- Primary address (JSON string)billable_time- Whether the employee’s time is billablebill_rate- Billable rateorganization- Whether the employee is an organizationemployee_number- Employee numberssn- Social security numberhired_date- Hire datereleased_date- Release datebirth_date- Birth dategender- Genderv4_id_pseudonym- Internal QuickBooks identifier
estimates
estimates
Estimates and quotes issued to customers. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datetxn_status- Estimate status (Pending, Accepted, Closed, Rejected)customer_ref- Customer reference (JSON string)customer_memo- Customer memo (JSON string)bill_addr- Billing address (JSON string)ship_addr- Shipping address (JSON string)ship_from_addr- Ship-from address (JSON string)free_form_address- Free-form address (JSON string)ship_date- Ship dateexpiration_date- Expiration dateaccepted_by- Name of the person who accepted the estimateaccepted_date- Date the estimate was acceptedline- Estimate lines (JSON string)txn_tax_detail- Transaction tax detail (JSON string)sales_term_ref- Sales term reference (JSON string)total_amt- Total amountapply_tax_after_discount- Whether tax is applied after discountprint_status- Print statusemail_status- Email statusbill_email- Billing email (JSON string)currency_ref- Currency reference (JSON string)exchange_rate- Currency exchange rateclass_ref- Class reference (JSON string)department_ref- Department reference (JSON string)private_note- Private notelinked_txn- Linked transactions (JSON string)custom_field- Custom fields (JSON string)global_tax_calculation- Global tax calculation mode
invoices
invoices
Sales invoices. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datedue_date- Due dateship_date- Ship datecustomer_ref- Customer reference (JSON string)customer_memo- Customer memo (JSON string)bill_addr- Billing address (JSON string)ship_addr- Shipping address (JSON string)ship_from_addr- Ship-from address (JSON string)free_form_address- Free-form address (JSON string)line- Invoice lines (JSON string)txn_tax_detail- Transaction tax detail (JSON string)sales_term_ref- Sales term reference (JSON string)total_amt- Total amounthome_total_amt- Total amount in home currencybalance- Outstanding balancedeposit- Deposit appliedapply_tax_after_discount- Whether tax is applied after discountprint_status- Print statusemail_status- Email statuse_invoice_status- E-invoice statusbill_email- Billing email (JSON string)bill_email_bcc- Billing email BCC (JSON string)delivery_info- Delivery information (JSON string)currency_ref- Currency reference (JSON string)exchange_rate- Currency exchange ratedeposit_to_account_ref- Deposit-to account reference (JSON string)class_ref- Class reference (JSON string)department_ref- Department reference (JSON string)ship_method_ref- Shipping method reference (JSON string)tracking_num- Tracking numberprivate_note- Private notelinked_txn- Linked transactions such as payments (JSON string)custom_field- Custom fields (JSON string)global_tax_calculation- Global tax calculation modeallow_ipn_payment- Whether Intuit PaymentNetwork payment is allowedallow_online_payment- Whether online payment is allowedallow_online_credit_card_payment- Whether online credit card payment is allowedallow_online_ach_payment- Whether online ACH payment is allowed
items
items
Products and services. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive items.name- Item namefully_qualified_name- Fully qualified name including parent hierarchyactive- Whether the item is activetype- Item type (Inventory, NonInventory, Service, etc.)description- Sales descriptionpurchase_desc- Purchase descriptionunit_price- Unit pricepurchase_cost- Purchase costtaxable- Whether the item is taxablesales_tax_included- Whether sales tax is included in the priceqty_on_hand- Quantity on handtrack_qty_on_hand- Whether quantity on hand is trackedinv_start_date- Inventory start datesku- Stock keeping unitincome_account_ref- Income account reference (JSON string)expense_account_ref- Expense account reference (JSON string)asset_account_ref- Asset account reference (JSON string)sales_tax_code_ref- Sales tax code reference (JSON string)purchase_tax_code_ref- Purchase tax code reference (JSON string)tax_classification_ref- Tax classification reference (JSON string)parent_ref- Parent item reference (JSON string)sub_item- Whether this is a sub-itemlevel- Hierarchy levelprint_grouped_items- Whether grouped items are printeditem_group_detail- Group item detail (JSON string)
journal_entries
journal_entries
Journal entries. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction dateadjustment- Whether the entry is an adjustmentline- Journal entry lines with debits and credits (JSON string)txn_tax_detail- Transaction tax detail (JSON string)total_amt- Total amounthome_total_amt- Total amount in home currencycurrency_ref- Currency reference (JSON string)exchange_rate- Currency exchange rateprivate_note- Private notetxn_source- Transaction sourcelinked_txn- Linked transactions (JSON string)recur_data_ref- Recurring transaction reference (JSON string)global_tax_calculation- Global tax calculation mode
payment_methods
payment_methods
Payment methods. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive payment methods.name- Payment method nameactive- Whether the payment method is activetype- Payment method type (e.g. CreditCard, NonCreditCard)
payments
payments
Payments received from customers. Primary key:
id. Sync: Incremental on last_updated_time.txn_date- Transaction datecustomer_ref- Customer reference (JSON string)total_amt- Total amountunapplied_amt- Unapplied amountline- Payment lines linking to invoices (JSON string)deposit_to_account_ref- Deposit-to account reference (JSON string)ar_account_ref- Accounts receivable account reference (JSON string)payment_method_ref- Payment method reference (JSON string)payment_ref_num- Payment reference numbercredit_card_payment- Credit card payment details (JSON string)currency_ref- Currency reference (JSON string)exchange_rate- Currency exchange rateprocess_payment- Whether the payment is processed electronicallytxn_source- Transaction sourceprivate_note- Private note
purchase_orders
purchase_orders
Purchase orders raised against vendors. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datedue_date- Due dateexpected_date- Expected datevendor_ref- Vendor reference (JSON string)ap_account_ref- Accounts payable account reference (JSON string)po_status- Purchase order status (Open, Closed)line- Purchase order lines (JSON string)txn_tax_detail- Transaction tax detail (JSON string)total_amt- Total amountship_addr- Shipping address (JSON string)vendor_addr- Vendor address (JSON string)ship_to- Ship-to reference (JSON string)ship_method_ref- Shipping method reference (JSON string)class_ref- Class reference (JSON string)department_ref- Department reference (JSON string)currency_ref- Currency reference (JSON string)exchange_rate- Currency exchange ratememo- Memoprivate_note- Private noteemail_status- Email statuspo_email- Purchase order email (JSON string)custom_field- Custom fields (JSON string)global_tax_calculation- Global tax calculation mode
purchases
purchases
Purchases such as expenses, checks, and credit card charges. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datepayment_type- Payment type (Cash, Check, CreditCard)account_ref- Account reference (JSON string)entity_ref- Payee/entity reference (JSON string)payment_method_ref- Payment method reference (JSON string)line- Purchase lines (JSON string)txn_tax_detail- Transaction tax detail (JSON string)total_amt- Total amountcredit- Whether the purchase is a creditpurchase_ex- Purchase extension detail (JSON string)remit_to_addr- Remit-to address (JSON string)currency_ref- Currency reference (JSON string)exchange_rate- Currency exchange ratedepartment_ref- Department reference (JSON string)print_status- Print statusprivate_note- Private notecustom_field- Custom fields (JSON string)global_tax_calculation- Global tax calculation mode
refund_receipts
refund_receipts
Refund receipts issued to customers. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datecustomer_ref- Customer reference (JSON string)bill_addr- Billing address (JSON string)line- Refund receipt lines (JSON string)txn_tax_detail- Transaction tax detail (JSON string)total_amt- Total amountbalance- Outstanding balancepayment_method_ref- Payment method reference (JSON string)deposit_to_account_ref- Account the refund is paid from (JSON string)check_payment- Check payment details (JSON string)credit_card_payment- Credit card payment details (JSON string)currency_ref- Currency reference (JSON string)exchange_rate- Currency exchange rateclass_ref- Class reference (JSON string)department_ref- Department reference (JSON string)private_note- Private notecustom_field- Custom fields (JSON string)global_tax_calculation- Global tax calculation mode
sales_receipts
sales_receipts
Sales receipts for immediate payment sales. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datecustomer_ref- Customer reference (JSON string)customer_memo- Customer memo (JSON string)bill_addr- Billing address (JSON string)ship_addr- Shipping address (JSON string)free_form_address- Free-form address (JSON string)ship_date- Ship dateline- Sales receipt lines (JSON string)txn_tax_detail- Transaction tax detail (JSON string)total_amt- Total amountbalance- Outstanding balancepayment_method_ref- Payment method reference (JSON string)payment_ref_num- Payment reference numberdeposit_to_account_ref- Deposit-to account reference (JSON string)credit_card_payment- Credit card payment details (JSON string)apply_tax_after_discount- Whether tax is applied after discountprint_status- Print statusemail_status- Email statusbill_email- Billing email (JSON string)currency_ref- Currency reference (JSON string)exchange_rate- Currency exchange rateclass_ref- Class reference (JSON string)department_ref- Department reference (JSON string)private_note- Private notecustom_field- Custom fields (JSON string)global_tax_calculation- Global tax calculation mode
tax_codes
tax_codes
Tax codes. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive tax codes.name- Tax code namedescription- Tax code descriptionactive- Whether the tax code is activetaxable- Whether the tax code is taxabletax_group- Whether the tax code is a grouphidden- Whether the tax code is hiddensales_tax_rate_list- Sales tax rate list (JSON string)purchase_tax_rate_list- Purchase tax rate list (JSON string)
terms
terms
Payment terms. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive terms.name- Term nameactive- Whether the term is activetype- Term type (Standard or DateDriven)due_days- Number of days until duediscount_days- Number of days to qualify for a discountdiscount_percent- Discount percentageday_of_month_due- Day of the month the payment is duedue_next_month_days- Days before which the due date rolls to the next monthdiscount_day_of_month- Day of the month to qualify for a discount
time_activities
time_activities
Time activities logged against customers, employees, or vendors. Primary key:
id. Sync: Incremental on last_updated_time.txn_date- Transaction datename_of- Whether the time is for an Employee or Vendoremployee_ref- Employee reference (JSON string)vendor_ref- Vendor reference (JSON string)customer_ref- Customer reference (JSON string)item_ref- Service item reference (JSON string)class_ref- Class reference (JSON string)department_ref- Department reference (JSON string)billable_status- Billable statustaxable- Whether the time is taxablehourly_rate- Hourly ratehours- Hours workedminutes- Minutes workedbreak_hours- Break hoursbreak_minutes- Break minutesstart_time- Start timeend_time- End timedescription- Description
transfers
transfers
Transfers of funds between accounts. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datefrom_account_ref- Source account reference (JSON string)to_account_ref- Destination account reference (JSON string)amount- Transfer amountcurrency_ref- Currency reference (JSON string)exchange_rate- Currency exchange rateprivate_note- Private note
vendor_credits
vendor_credits
Vendor credits. Primary key:
id. Sync: Incremental on last_updated_time.doc_number- Document numbertxn_date- Transaction datevendor_ref- Vendor reference (JSON string)ap_account_ref- Accounts payable account reference (JSON string)line- Vendor credit lines (JSON string)txn_tax_detail- Transaction tax detail (JSON string)total_amt- Total amountbalance- Outstanding balancecurrency_ref- Currency reference (JSON string)exchange_rate- Currency exchange ratedepartment_ref- Department reference (JSON string)private_note- Private noteglobal_tax_calculation- Global tax calculation mode
vendors
vendors
Vendors and suppliers. Primary key:
id. Sync: Incremental on last_updated_time. Includes active and inactive vendors.display_name- Display nametitle- Titlegiven_name- First namemiddle_name- Middle namefamily_name- Last namesuffix- Name suffixcompany_name- Company nameprint_on_check_name- Name to print on checksactive- Whether the vendor is activeprimary_email_addr- Primary email address (JSON string)primary_phone- Primary phone (JSON string)mobile- Mobile phone (JSON string)fax- Fax (JSON string)web_addr- Website address (JSON string)bill_addr- Billing address (JSON string)balance- Outstanding balancevendor1099- Whether the vendor is a 1099 vendortax_identifier- Tax identifieracct_num- Account numberbill_rate- Billable ratecost_rate- Cost ratecurrency_ref- Currency reference (JSON string)term_ref- Term reference (JSON string)ap_account_ref- Accounts payable account reference (JSON string)v4_id_pseudonym- Internal QuickBooks identifier
Skills for agents
Download QuickBooks skills file
QuickBooks connector documentation as plain markdown, for use in AI agent contexts.