POST
/
unified
/
accounting
/
companies
/
{id}
/
journals
Create Journal
curl --request POST \
  --url https://api.stackone.com/unified/accounting/companies/{id}/journals \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '{
  "reference": "JRN-2024-001",
  "memo": "Monthly closing entries",
  "currency_code": {
    "value": "USD",
    "source_value": "USD"
  },
  "exchange_rate": 1,
  "transaction_date": "2024-03-20T10:00:00Z",
  "lines": [
    {
      "account_id": "acc_123456789",
      "description": "Payment for office supplies",
      "amount": 10010,
      "tax_rate_id": "tax_123456789",
      "tax_amount": 10010
    }
  ]
}'
{
  "statusCode": 201,
  "message": "Record created successfully.",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"
  }
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

x-account-id
string
required

The account identifier

Path Parameters

id
string
required

Body

application/json
reference
string | null

Reference number for the journal

Example:

"JRN-2024-001"

memo
string | null

Memo or description for the journal

Example:

"Monthly closing entries"

currency_code
object

Currency code for the journal and all lines

exchange_rate
number | null

Exchange rate to company base currency to apply to all lines

Example:

1

transaction_date
string<date-time> | null

Date of the journal transaction

Example:

"2024-03-20T10:00:00Z"

lines
object[] | null

List of journal lines

Response

The journal was created successfully.

statusCode
number
required
Example:

201

message
string
required
Example:

"Record created successfully."

timestamp
string<date-time>
required
Example:

"2021-01-01T01:01:01.000Z"

data
object
required