Skip to main content
POST
Create Journal Entry

Authorizations

Authorization
string
header
required

Token-based authentication with required prefix "Token"

Body

reversal_date
string<date> | null
write-only
order
string
revenue_transactions
integer[]
write-only
bulk_upload
boolean
write-only
chat_uuid
string<uuid> | null
write-only
close_task_id
string
update_reversal
boolean
default:false
write-only
journals_to_delete
integer[]
write-only
type
enum<string>
  • bill - Bill
  • bill_payment - Bill Payment
  • bill_prepayment - Bill Prepayment
  • check - Check
  • credit_card - Credit Card
  • credit_memo - Credit Memo
  • credit_memo_payment - Credit Memo Payment
  • debit_memo - Debit Memo
  • debit_memo_payment - Debit Memo Payment
  • deposit - Deposit
  • expense - Expense
  • invoice - Invoice
  • intercompany_journal - Intercompany Journal
  • invoice_payment - Invoice Payment
  • journal_entry - Journal Entry
  • lease - Lease
  • payment - Payment
  • receive_payment - Receive Payment
  • refund - Refund
  • revenue_recognition - Revenue Recognition
  • sales_receipt - Sales Receipt
  • transfer - Transfer
  • vendor_credit - Vendor Credit
  • void_bill - Void Bill
  • void_bill_payment - Void Bill Payment
  • void_invoice_payment - Void Invoice Payment
  • void_credit_memo - Void Credit Memo
  • void_credit_memo_payment - Void Credit Memo Payment
  • void_debit_memo_payment - Void Debit Memo Payment
  • void_invoice - Void Invoice
  • elimination - Elimination
  • revaluation - Revaluation
  • asset_reclassification - Asset Reclassification
Available options:
bill,
bill_payment,
bill_prepayment,
check,
credit_card,
credit_memo,
credit_memo_payment,
debit_memo,
debit_memo_payment,
deposit,
expense,
invoice,
intercompany_journal,
invoice_payment,
journal_entry,
lease,
payment,
receive_payment,
refund,
revenue_recognition,
sales_receipt,
transfer,
vendor_credit,
void_bill,
void_bill_payment,
void_invoice_payment,
void_credit_memo,
void_credit_memo_payment,
void_debit_memo_payment,
void_invoice,
elimination,
revaluation,
asset_reclassification
journal_id
string<uuid>
memo
string | null
currency
string
Maximum string length: 3
exchange_rate
number<double> | null
Required range: -100000000000000 < x < 100000000000000
exchange_rate_book
number<double> | null
Required range: -100000000000000 < x < 100000000000000
use_average_rate
boolean | null
created_automatically
boolean
date
string<date>
ref_number
string | null
Maximum string length: 100
source
string | null
Maximum string length: 250
source_id
string | null
recurrent_journal_entry
integer | null
entity
integer | null
reversal_of
integer | null
intercompany_journal
integer | null
source_file
integer | null
chat
integer | null

Response

201 - application/json
id
integer
required
read-only
is_deleted
boolean
default:false
required
read-only
deleted_at
string<date-time> | null
required
read-only
transactions
object[]
required
read-only
attachments
object[]
required
read-only
invoice
integer | null
required
read-only
reversal_of_order
string
required
read-only
reversals
object[]
required
read-only
entity_name
string
required
read-only
entity_currency
string
required
read-only
created_by
integer | null
required
read-only

Derived user ID of the journal entry creator. Check created_by_source before explaining provenance.

created_by_name
string | null
required
read-only

Derived name of the journal entry creator. Check created_by_source before explaining provenance.

created_by_source
string | null
required
read-only

Provenance for created_by and created_by_name: 'draft_queue_created_by', 'chart_transaction_last_modified_by_fallback', or null.

credit_memos
object[]
required
read-only
debit_memos
object[]
required
read-only
ramp_use_sandbox
string
required
read-only
navan_region
string | null
required
read-only

Navan data region (US/EU) for a Navan-sourced journal entry, else None.

Mirrors ramp_use_sandbox: the frontend builds the "Open in Navan" deep link from source_id and uses this to pick the web-app host (US -> app.navan.com, EU -> app-fra.navan.com). Navan records carry no FK to their connection, so the region is resolved per customer and memoized to avoid an N+1 lookup across a transaction list.

float_bill_id
string | null
required
read-only

Float id of the bill paid by a Float bill-payment journal entry, else None.

Payment journal entries store the Float payment id as source_id, which has no page of its own in Float's web app — the frontend deep-links "View on Float" to the paid bill instead.

search_vector
string | null
required
read-only
search_text
string | null
required
read-only
created_at
string<date-time>
required
read-only
last_modified_at
string<date-time>
required
read-only
customer
integer
required
read-only
last_draft
integer | null
required
read-only
order
string
close_task_id
string
type
enum<string>
  • bill - Bill
  • bill_payment - Bill Payment
  • bill_prepayment - Bill Prepayment
  • check - Check
  • credit_card - Credit Card
  • credit_memo - Credit Memo
  • credit_memo_payment - Credit Memo Payment
  • debit_memo - Debit Memo
  • debit_memo_payment - Debit Memo Payment
  • deposit - Deposit
  • expense - Expense
  • invoice - Invoice
  • intercompany_journal - Intercompany Journal
  • invoice_payment - Invoice Payment
  • journal_entry - Journal Entry
  • lease - Lease
  • payment - Payment
  • receive_payment - Receive Payment
  • refund - Refund
  • revenue_recognition - Revenue Recognition
  • sales_receipt - Sales Receipt
  • transfer - Transfer
  • vendor_credit - Vendor Credit
  • void_bill - Void Bill
  • void_bill_payment - Void Bill Payment
  • void_invoice_payment - Void Invoice Payment
  • void_credit_memo - Void Credit Memo
  • void_credit_memo_payment - Void Credit Memo Payment
  • void_debit_memo_payment - Void Debit Memo Payment
  • void_invoice - Void Invoice
  • elimination - Elimination
  • revaluation - Revaluation
  • asset_reclassification - Asset Reclassification
Available options:
bill,
bill_payment,
bill_prepayment,
check,
credit_card,
credit_memo,
credit_memo_payment,
debit_memo,
debit_memo_payment,
deposit,
expense,
invoice,
intercompany_journal,
invoice_payment,
journal_entry,
lease,
payment,
receive_payment,
refund,
revenue_recognition,
sales_receipt,
transfer,
vendor_credit,
void_bill,
void_bill_payment,
void_invoice_payment,
void_credit_memo,
void_credit_memo_payment,
void_debit_memo_payment,
void_invoice,
elimination,
revaluation,
asset_reclassification
journal_id
string<uuid>
memo
string | null
currency
string
Maximum string length: 3
exchange_rate
number<double> | null
Required range: -100000000000000 < x < 100000000000000
exchange_rate_book
number<double> | null
Required range: -100000000000000 < x < 100000000000000
use_average_rate
boolean | null
created_automatically
boolean
date
string<date>
ref_number
string | null
Maximum string length: 100
source
string | null
Maximum string length: 250
source_id
string | null
recurrent_journal_entry
integer | null
entity
integer | null
reversal_of
integer | null
intercompany_journal
integer | null
source_file
integer | null
chat
integer | null