---
title: "Create Journal"
method: POST
path: "/v2/ledger/journal"
---

# Create Journal

`POST /v2/ledger/journal`

## Headers

- `client_id` string, required
- `client_secret` string, required
- `module_secret` string, required

## Request body

- object
  - `reference_id` string, required — Your unique API reference id
  - `name` string, required — Name to be assigned for the Journal
  - `purpose` string, required — Purpose of the Journal
  - `consent` boolean, required — Consent of creation
  - `additional_parameters` object[] — User defined parameters that can be added by the client
    - `key` string
    - `value` string

## Response `200`

200

- object
  - `decentroTxnId` string
  - `status` string
  - `responseCode` string
  - `message` string
  - `data` object
    - `transactionStatus` string
    - `transactionDescription` string
    - `urn` string
    - `referenceId` string
    - `name` string
    - `purpose` string
    - `additionalParameters` object
      - `udf1` string
      - `udf2` string
      - `udf3` string
      - `udf4` string
      - `width` string
    - `status` string
    - `creationTimestamp` string
    - `lastModificationTimestamp` string

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/decentro/apis/decentro-staging.md) · [All operations](https://skmtc.dev/decentro/apis/decentro-staging/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decentro/decentro-staging/revisions/f1a86ce4638c/schema)