QuickBooks

Connect fyrn to QuickBooks Online to automate accounting workflows — create invoices, manage customers, record payments, and track items through the Intuit QuickBooks API.

Overview

Property	Value
Type	http
Authentication	oauth2
Category	Finance & Accounting

Configuration

Field	Type	Required	Description
realm_id	string	Yes	QuickBooks company ID (realmId)
client_id	string	Yes	Intuit OAuth2 client ID
client_secret	string	Yes	Intuit OAuth2 client secret
refresh_token	string	Yes	OAuth2 refresh token
environment	string	No	API environment: sandbox or production (default: production)

Available actions

Query

Execute a QuickBooks query to retrieve entities using SQL-like syntax.

Endpoint	GET /query
Method	GET

Create Invoice

Create a new invoice in QuickBooks Online.

Endpoint	POST /invoice
Method	POST

Get Invoice

Retrieve an invoice by ID from QuickBooks Online.

Endpoint	GET /invoice/{invoiceId}
Method	GET

Update Invoice

Update an existing invoice in QuickBooks Online. Requires Id and SyncToken for optimistic locking.

Endpoint	POST /invoice
Method	POST

Create Customer

Create a new customer in QuickBooks Online.

Endpoint	POST /customer
Method	POST

Get Customer

Retrieve a customer by ID from QuickBooks Online.

Endpoint	GET /customer/{customerId}
Method	GET

Create Payment

Record a payment received from a customer in QuickBooks Online.

Endpoint	POST /payment
Method	POST

Get Payment

Retrieve a payment by ID from QuickBooks Online.

Endpoint	GET /payment/{paymentId}
Method	GET

Create Item

Create a new product or service item in QuickBooks Online.

Endpoint	POST /item
Method	POST

Get Company Info

Retrieve company profile information from QuickBooks Online.

Endpoint	GET /companyinfo/{companyId}
Method	GET

Example flow

name: stripe-to-quickbooks
description: When a Stripe payment succeeds, create a matching invoice and payment in QuickBooks
trigger:
  type: webhook
  event: stripe.payment_intent.succeeded

steps:
  - id: find-or-create-customer
    connector: quickbooks
    action: create-customer
    params:
      DisplayName: "{{ trigger.body.data.object.metadata.customer_name }}"
      PrimaryEmailAddr:
        Address: "{{ trigger.body.data.object.receipt_email }}"

  - id: create-invoice
    connector: quickbooks
    action: create-invoice
    params:
      CustomerRef:
        value: "{{ steps.find-or-create-customer.result.Customer.Id }}"
      Line:
        - Amount: "{{ trigger.body.data.object.amount | divided_by: 100.0 }}"
          DetailType: "SalesItemLineDetail"
          SalesItemLineDetail:
            ItemRef:
              value: "1"

  - id: record-payment
    connector: quickbooks
    action: create-payment
    params:
      CustomerRef:
        value: "{{ steps.find-or-create-customer.result.Customer.Id }}"
      TotalAmt: "{{ trigger.body.data.object.amount | divided_by: 100.0 }}"
      Line:
        - Amount: "{{ trigger.body.data.object.amount | divided_by: 100.0 }}"
          LinkedTxn:
            - TxnId: "{{ steps.create-invoice.result.Invoice.Id }}"
              TxnType: "Invoice"