---
title: "Create a record"
method: POST
path: "/records"
---

# Create a record

`POST /records`

## Request body

- Record
  - `id` integer
  - `amount` integer, required — The monetary amount in cents (e.g., 1234 = $12.34)
  - `currency` string — Three-letter ISO 4217 currency code (e.g. USD, EUR). **Optional on create — defaults to `USD` when omitted.** Case-insensitive on input; always returned uppercase.
  - `decimal_places` integer — Number of decimal places for this currency (2 for USD)
  - `direction` 'credit' | 'debit', required
  - `description` string
  - `date` string, date, required
  - `metadata` object
  - `external_id` string
  - `data_stream_key` string, required

## Response `201`

Record created

- Record
  - `id` integer
  - `amount` integer, required — The monetary amount in cents (e.g., 1234 = $12.34)
  - `currency` string — Three-letter ISO 4217 currency code (e.g. USD, EUR). **Optional on create — defaults to `USD` when omitted.** Case-insensitive on input; always returned uppercase.
  - `decimal_places` integer — Number of decimal places for this currency (2 for USD)
  - `direction` 'credit' | 'debit', required
  - `description` string
  - `date` string, date, required
  - `metadata` object
  - `external_id` string
  - `data_stream_key` string, required

---

[API](https://skmtc.net/endclose/apis/end-close-api.md) · [All operations](https://skmtc.net/endclose/apis/end-close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/endclose/end-close-api/revisions/613ceff68dc7/schema)