Create a journal entry

Authorizations

Authorization

string

header

required

Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}").

Headers

Conductor-End-User-Id

string

required

The ID of the EndUser to receive this request (e.g., "Conductor-End-User-Id: {{END_USER_ID}}").

Body

application/json

transactionDate

string

required

The date of this journal entry, in ISO 8601 format (YYYY-MM-DD).

areAmountsEnteredInHomeCurrency

boolean

Indicates whether the amounts in this journal entry were entered in the company's home currency rather than a foreign currency. When true, amounts are in the home currency regardless of the currency field.

creditLines

object[]

The journal entry's credit lines.

currencyId

string

The journal entry's currency. For built-in currencies, the name and code are standard international values. For user-defined currencies, all values are editable.

debitLines

object[]

The journal entry's debit lines.

exchangeRate

number

The market exchange rate between this journal entry's currency and the home currency in QuickBooks at the time of this transaction. Represented as a decimal value (e.g., 1.2345 for 1 EUR = 1.2345 USD if USD is the home currency).

externalId

string

A globally unique identifier (GUID) you, the developer, can provide for tracking this object in your external system.

IMPORTANT: Must be formatted as a valid GUID; otherwise, QuickBooks will return an error. This field is immutable and can only be set during object creation.

isAdjustment

boolean

Indicates whether this journal entry is an adjustment entry. When true, QuickBooks retains the original entry information to maintain an audit trail of the adjustments.

isHomeCurrencyAdjustment

boolean

Indicates whether this journal entry is an adjustment made in the company's home currency for a transaction that was originally recorded in a foreign currency.

refNumber

string

The case-sensitive user-defined reference number for this journal entry, which can be used to identify the transaction in QuickBooks. This value is not required to be unique and can be arbitrarily changed by the QuickBooks user.

Response

200 - application/json

areAmountsEnteredInHomeCurrency

boolean | null

required

createdAt

string

required

The date and time when this journal entry was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user's time zone in QuickBooks.

creditLines

object[]

required

The journal entry's credit lines.

creditLines.account

object

required

The account to which this journal credit line is being credited. This will increase the balance of this account.

creditLines.amount

string | null

required

The monetary amount of this journal credit line, represented as a decimal string.

creditLines.billingStatus

enum<string> | null

required

The billing status of this journal credit line.

Available options:

billable,

has_been_billed,

not_billable

creditLines.class

object | null

required

The journal credit line's class. Classes can be used to categorize objects into meaningful segments, such as department, location, or type of work. In QuickBooks, class tracking is off by default. If a class is specified for the entire parent transaction, it is automatically applied to all journal credit lines unless overridden here, at the transaction line level.

creditLines.entity

object | null

required

The customer, vendor, employee, or other entity associated with this journal credit line.

IMPORTANT: If the journal credit line's account is an Accounts Receivable (A/R) account, this field must refer to a customer. If the journal credit line's account is an Accounts Payable (A/P) account, this field must refer to a vendor. If these requirements are not met, QuickBooks Desktop will not record the transaction.

creditLines.id

string

required

The unique identifier assigned by QuickBooks to this journal credit line. This ID is unique across all transaction line types.

creditLines.memo

string | null

required

A memo or note for this journal credit line.

creditLines.objectType

string

required

The type of object. This value is always "qbd_journal_credit_line".

Allowed value: "qbd_journal_credit_line"

creditLines.salesTaxItem

object | null

required

The sales-tax item used to calculate the actual tax amount for this journal credit line's transactions by applying a specific tax rate collected for a single tax agency. Unlike salesTaxCode, which only indicates general taxability, this field drives the actual tax calculation and reporting.

currency

object | null

required

The journal entry's currency. For built-in currencies, the name and code are standard international values. For user-defined currencies, all values are editable.

customFields

object[]

required

The custom fields for the journal entry object, added as user-defined data extensions, not included in the standard QuickBooks object.

debitLines

object[]

required

The journal entry's debit lines.

debitLines.account

object

required

The account to which this journal debit line is being debited. This will decrease the balance of this account.

debitLines.amount

string | null

required

The monetary amount of this journal debit line, represented as a decimal string.

debitLines.billingStatus

enum<string> | null

required

The billing status of this journal debit line.

Available options:

billable,

has_been_billed,

not_billable

debitLines.class

object | null

required

The journal debit line's class. Classes can be used to categorize objects into meaningful segments, such as department, location, or type of work. In QuickBooks, class tracking is off by default. If a class is specified for the entire parent transaction, it is automatically applied to all journal debit lines unless overridden here, at the transaction line level.

debitLines.entity

object | null

required

The customer, vendor, employee, or other entity associated with this journal debit line.

IMPORTANT: If the journal debit line's account is an Accounts Receivable (A/R) account, this field must refer to a customer. If the journal debit line's account is an Accounts Payable (A/P) account, this field must refer to a vendor. If these requirements are not met, QuickBooks Desktop will not record the transaction.

debitLines.id

string

required

The unique identifier assigned by QuickBooks to this journal debit line. This ID is unique across all transaction line types.

debitLines.memo

string | null

required

A memo or note for this journal debit line.

debitLines.objectType

string

required

The type of object. This value is always "qbd_journal_debit_line".

Allowed value: "qbd_journal_debit_line"

debitLines.salesTaxItem

object | null

required

The sales-tax item used to calculate the actual tax amount for this journal debit line's transactions by applying a specific tax rate collected for a single tax agency. Unlike salesTaxCode, which only indicates general taxability, this field drives the actual tax calculation and reporting.

exchangeRate

number | null

required

externalId

string | null

required

A globally unique identifier (GUID) you, the developer, can provide for tracking this object in your external system.

string

required

The unique identifier assigned by QuickBooks to this journal entry. This ID is unique across all transaction types.

isAdjustment

boolean | null

required

Indicates whether this journal entry is an adjustment entry. When true, QuickBooks retains the original entry information to maintain an audit trail of the adjustments.

isHomeCurrencyAdjustment

boolean | null

required

Indicates whether this journal entry is an adjustment made in the company's home currency for a transaction that was originally recorded in a foreign currency.

objectType

string

required

The type of object. This value is always "qbd_journal_entry".

Allowed value: "qbd_journal_entry"

refNumber

string | null

required

revisionNumber

string

required

The current revision number of this journal entry object, which changes each time the object is modified. When updating this object, you must provide the most recent revisionNumber to ensure you're working with the latest data; otherwise, the update will return an error.

transactionDate

string

required

The date of this journal entry, in ISO 8601 format (YYYY-MM-DD).

updatedAt

string

required

The date and time when this journal entry was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user's time zone in QuickBooks.

QuickBooks Desktop API

Core Resources

Transactions

Items

Authorizations

Headers

Body

Response