Journal Entries
Update a Journal Entry
Teal API Endpoints
- Categorization
- Chart of Accounts Templates
- Instances
- Journal Entries
- Ledgers
- Line Entries
- Payables
- Platform
- Quickbooks
- Receivables
- Reports
- Tags
- Transaction Sources
- Transactions
- Transfers
API Migration
- Migration Guides
- Deprecated Endpoints
Journal Entries
Update a Journal Entry
Updates an existing Journal Entry’s details or Line Entries. When updating Line Entries in the Journal Entry, debit and credit amounts must equal.
PUT
/
v0
/
journal-entries
/
{journal_entry_id}
curl --request PUT \
--url https://api.sandbox.teal.dev/v0/journal-entries/{journal_entry_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'teal-instance-id: <teal-instance-id>' \
--data '{
"datetime": "2023-02-15T06:42:18Z",
"description": "Payroll#230215",
"line_entry_changes": {
"create": [
{
"amount": 31282.28,
"debit_credit": "credit",
"description": "Payroll#230215",
"ledger_id": "7JRNsKwy2Lw66caxVU7WGC",
"tag_ids": [
"<string>"
]
}
],
"update": [
{
"id": "XMDsKVuW4Wmi3LTW31Qw6E",
"amount": 31282.28,
"debit_credit": "credit",
"description": "<string>",
"ledger_id": "7JRNsKwy2Lw66caxVU7WGC",
"tag_ids": [
"<string>"
]
}
],
"delete": [
"<string>"
]
}
}'
{
"id": "C4ocnUQze8kDwQ3EczkZXn",
"description": "Payroll#230215",
"datetime": "2023-02-15T06:42:18Z",
"files": null,
"line_entry_ids": [
"XMDsKVuW4Wmi3LTW31Qw6E",
"NULcvXTkLczde32qs1rqgB"
],
"linked_entity": {
"type": "receivable",
"id": "<string>"
},
"line_entries": [
{
"amount": 31282.28,
"datetime": "2023-02-15T06:42:18Z",
"debit_credit": "debit",
"description": "Payroll#230215",
"editable": false,
"id": "XMDsKVuW4Wmi3LTW31Qw6E",
"journal_entry_description": "Payroll#230215",
"journal_entry_id": "C4ocnUQze8kDwQ3EczkZXn",
"ledger_id": "7JRNsKwy2Lw66caxVU7WGC",
"ledger_name": "Pluto Checking 4242",
"tags": [],
"transaction_id": "txn_UjL3BQnEaJtecuC7CUeDk"
},
{
"amount": 31282.28,
"datetime": "2023-02-15T06:42:18Z",
"debit_credit": "credit",
"description": "Payroll#230215",
"editable": false,
"id": "NULcvXTkLczde32qs1rqgB",
"journal_entry_description": "Payroll#230215",
"journal_entry_id": "C4ocnUQze8kDwQ3EczkZXn",
"ledger_id": "HLn8oy2eqMUCwjp1Cwdgco",
"ledger_name": "Payroll Expense",
"tags": []
}
]
}
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Headers
The Teal instance ID
An optional identifier for audit logging.
Path Parameters
Journal entry ID
Query Parameters
Comma-separated list of expand paths.
Body
application/json
Response
201
application/json
Successful Response
The response is of type object
.
curl --request PUT \
--url https://api.sandbox.teal.dev/v0/journal-entries/{journal_entry_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'teal-instance-id: <teal-instance-id>' \
--data '{
"datetime": "2023-02-15T06:42:18Z",
"description": "Payroll#230215",
"line_entry_changes": {
"create": [
{
"amount": 31282.28,
"debit_credit": "credit",
"description": "Payroll#230215",
"ledger_id": "7JRNsKwy2Lw66caxVU7WGC",
"tag_ids": [
"<string>"
]
}
],
"update": [
{
"id": "XMDsKVuW4Wmi3LTW31Qw6E",
"amount": 31282.28,
"debit_credit": "credit",
"description": "<string>",
"ledger_id": "7JRNsKwy2Lw66caxVU7WGC",
"tag_ids": [
"<string>"
]
}
],
"delete": [
"<string>"
]
}
}'
{
"id": "C4ocnUQze8kDwQ3EczkZXn",
"description": "Payroll#230215",
"datetime": "2023-02-15T06:42:18Z",
"files": null,
"line_entry_ids": [
"XMDsKVuW4Wmi3LTW31Qw6E",
"NULcvXTkLczde32qs1rqgB"
],
"linked_entity": {
"type": "receivable",
"id": "<string>"
},
"line_entries": [
{
"amount": 31282.28,
"datetime": "2023-02-15T06:42:18Z",
"debit_credit": "debit",
"description": "Payroll#230215",
"editable": false,
"id": "XMDsKVuW4Wmi3LTW31Qw6E",
"journal_entry_description": "Payroll#230215",
"journal_entry_id": "C4ocnUQze8kDwQ3EczkZXn",
"ledger_id": "7JRNsKwy2Lw66caxVU7WGC",
"ledger_name": "Pluto Checking 4242",
"tags": [],
"transaction_id": "txn_UjL3BQnEaJtecuC7CUeDk"
},
{
"amount": 31282.28,
"datetime": "2023-02-15T06:42:18Z",
"debit_credit": "credit",
"description": "Payroll#230215",
"editable": false,
"id": "NULcvXTkLczde32qs1rqgB",
"journal_entry_description": "Payroll#230215",
"journal_entry_id": "C4ocnUQze8kDwQ3EczkZXn",
"ledger_id": "HLn8oy2eqMUCwjp1Cwdgco",
"ledger_name": "Payroll Expense",
"tags": []
}
]
}