Skip to main content
POST
/
create
/
journal
Create journal
curl --request POST \
  --url https://staging-api.usetyms.com/v1/adam/create/journal \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "description": "Accrue March rent",
  "date": "2026-03-31",
  "journal_no": "JE-2026-031",
  "currency": "NGN",
  "status": "draft",
  "items": [
    {
      "category": "Rent Expense",
      "debit": 250000,
      "credit": 0,
      "description": "March office rent"
    },
    {
      "category": "Accrued Expenses",
      "debit": 0,
      "credit": 250000,
      "description": "March office rent accrual"
    }
  ]
}
'
import requests

url = "https://staging-api.usetyms.com/v1/adam/create/journal"

payload = {
"description": "Accrue March rent",
"date": "2026-03-31",
"journal_no": "JE-2026-031",
"currency": "NGN",
"status": "draft",
"items": [
{
"category": "Rent Expense",
"debit": 250000,
"credit": 0,
"description": "March office rent"
},
{
"category": "Accrued Expenses",
"debit": 0,
"credit": 250000,
"description": "March office rent accrual"
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
description: 'Accrue March rent',
date: '2026-03-31',
journal_no: 'JE-2026-031',
currency: 'NGN',
status: 'draft',
items: [
{
category: 'Rent Expense',
debit: 250000,
credit: 0,
description: 'March office rent'
},
{
category: 'Accrued Expenses',
debit: 0,
credit: 250000,
description: 'March office rent accrual'
}
]
})
};

fetch('https://staging-api.usetyms.com/v1/adam/create/journal', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
{
  "status": "success",
  "message": "Journal created successfully",
  "data": {
    "uuid": "a6b7c8d9e0f1428290a1b2c3d4e5f6b7",
    "status": "draft",
    "journal_no": "JE-2026-031"
  }
}
{
"status": "failed",
"message": "<string>"
}

Authorizations

X-API-Key
string
header
default:your_tyms_sk_or_partner_key
required

Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.

Body

application/json
description
string
required

Journal title. Alias: title.

date
string<date>
required
items
object[]
required
Minimum array length: 2
journal_no
string
status
string

Default draft. Use published to post.

currency
string
exchange_rate
number

Response

Journal created

status
string
required
Example:

"success"

message
string
required
data
any

Single resource, array of resources, statement sections, or async job metadata — see each operation's example.

meta
object

Pagination (page, limit, total) and/or report range (from, to). Cash flow may include previous_period_end.