> ## Documentation Index > Fetch the complete documentation index at: https://docs.maesn.com/llms.txt > Use this file to discover all available pages before exploring further. # Create transaction ## Field support per integration }> This endpoints is asynchronous. To check the status of the request, use the `GET asyncTask` endpoint. For more info about asynchronous tasks visit the [`Asynchronous Task`](/async-task) section. If you're not using the [Interactive Authentication Flow](/authentication#interactive-authentication-flow), make sure the query parameter `companyId` is accurately populated with the appropriate company ID. You can obtain this value by using the `GET Companies` endpoint available under the Authentication section. Supported Request Parameters: The `id` field is the identifier for the transaction. It must match the pattern: `^[a-zA-Z0-9$%&*\+\-/]{0,36}$`. The `accountNumber` field specifies the general ledger account linked to the transaction. The `currency` field supports **ISO 3166-1 alpha-2** (2-letter codes). For details visits the [`Standardized Data`](/standardization) section. The `description` field provides details about the transaction. It cannot exceed 60 characters in length. The `ledgerName` field represents the name of the correct ledger folder where the data will be sent to. To get the correct name, you can use the `GET Accounts` endpoint. The `ledgerName` must be of type `CASH`. The `taxRatePercentage` field represents the tax rate applied to the transaction. It must be a positive number. `,}}/>}> If you're not using the [Interactive Authentication Flow](/authentication#interactive-authentication-flow), make sure the query parameter `companyId` is correctly populated. You can obtain this value by using the `GET Companies` endpoint available under the Authentication section. Supported Request Parameters: The `accountId` is the id of the GL account related to the transaction. You can obtain this value by using the `GET Accounts` endpoint. Available options (3-letter ISO 4217): `AED`, `AFN`, `ALL`, `AMD`, `ANG`, `AOA`, `ARS`, `AUD`, `AWG`, `AZN`, `BAM`, `BBD`, `BDT`, `BGN`, `BHD`, `BIF`, `BMD`, `BND`, `BOB`, `BRL`, `BSD`, `BTN`, `BWP`, `BYR`, `BZD`, `CAD`, `CDF`, `CHF`, `CLP`, `CNY`, `COP`, `CRC`, `CUC`, `CVE`, `CZK`, `DJF`, `DKK`, `DOP`, `DZD`, `EEK`, `EGP`, `ERN`, `ETB`, `EUR`, `FJD`, `FKP`, `GBP`, `GEL`, `GHS`, `GIP`, `GMD`, `GNF`, `GQE`, `GTQ`, `GYD`, `HKD`, `HNL`, `HRK`, `HTG`, `HUF`, `IDR`, `ILS`, `INR`, `IQD`, `IRR`, `ISK`, `JMD`, `JOD`, `JPY`, `KES`, `KGS`, `KHR`, `KMF`, `KPW`, `KRW`, `KWD`, `KYD`, `KZT`, `LAK`, `LBP`, `LKR`, `LRD`, `LSL`, `LTL`, `LVL`, `LYD`, `MAD`, `MDL`, `MGA`, `MKD`, `MMK`, `MNT`, `MOP`, `MRO`, `MUR`, `MVR`, `MWK`, `MXN`, `MYR`, `MZM`, `NAD`, `NGN`, `NIO`, `NOK`, `NPR`, `NZD`, `OMR`, `PAB`, `PEN`, `PGK`, `PHP`, `PKR`, `PLN`, `PYG`, `QAR`, `RON`, `RSD`, `RUB`, `SAR`, `SBD`, `SCR`, `SDG`, `SEK`, `SGD`, `SHP`, `SLL`, `SOS`, `SRD`, `SYP`, `SZL`, `THB`, `TJS`, `TMT`, `TND`, `TRY`, `TTD`, `TWD`, `TZS`, `UAH`, `UGX`, `USD`, `UYU`, `UZS`, `VEB`, `VND`, `VUV`, `WST`, `XAF`, `XCD`, `XDR`, `XOF`, `XPF`, `YER`, `ZAR`, `ZMK`, `ZWR` }> Supported Request Fields: The `accountId` is the id of the bank account related to the transaction. }> Supported Request Fields: The `accountId` is the id of the bank account related to the transaction. You can obtain this value by using the `GET Bank Accounts` endpoint. Available options: `CREATED`, `LINKED`, `PRIVATE`, `BOOKED` ## OpenAPI ````yaml post /accounting/transactions openapi: 3.0.0 info: title: Maesn unified API description: The Maesn unified API description version: '1.0' contact: {} servers: - url: https://api.maesn.dev security: [] tags: - name: maesn description: '' paths: /accounting/transactions: post: tags: - accounting operationId: createTransaction parameters: - name: companyId required: false in: query schema: type: string - name: journalCode required: false in: query schema: type: string - name: X-API-KEY description: API key in: header schema: type: string required: true - name: X-ACCOUNT-KEY description: Account key in: header schema: type: string required: true requestBody: required: true content: multipart/form-data: schema: type: object properties: files: type: array items: format: binary description: Array of files to upload transaction: $ref: '#/components/schemas/CreateTransactionRequestDto' responses: '200': description: '' content: application/json: schema: allOf: - $ref: '#/components/schemas/BaseResponseDto' - properties: data: $ref: '#/components/schemas/TransactionResponseDto' type: object components: schemas: CreateTransactionRequestDto: type: object properties: id: type: string example: f733a433-9662-4a40-8e36-e38ebda94fe1 accountId: type: string example: 14a6b5e92-a261-4be9-814d-84dec9636c16 accountNumber: type: number example: 4900 amount: type: number example: 100 bookingDate: type: string example: '2025-07-15T00:00:00Z' contact: type: string example: eaa28f49-6028-4b6e-bb12-d8f6278073fc currency: type: string enum: - AED - AFN - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BRL - BSD - BTN - BWP - BYR - BZD - CAD - CDF - CHF - CLP - CNY - COP - CRC - CUC - CVE - CZK - DJF - DKK - DOP - DZD - EEK - EGP - ERN - ETB - EUR - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GQE - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - INR - IQD - IRR - ISK - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LTL - LVL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRO - MUR - MVR - MWK - MXN - MYR - MZM - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - SAR - SBD - SCR - SDG - SEK - SGD - SHP - SLL - SOS - SRD - SYP - SZL - THB - TJS - TMT - TND - TRY - TTD - TWD - TZS - UAH - UGX - USD - UYU - UZS - VEB - VND - VUV - WST - XAF - XCD - XDR - XOF - XPF - YER - ZAR - ZMK - ZWR example: EUR description: type: string example: Hotel for dreamforce journalCode: type: string example: '31' ledgerName: type: string example: Payroll reference: type: string example: RCXF197253F status: type: string enum: - CREATED - LINKED - PRIVATE - BOOKED - AUTHORISED - DELETED taxRatePercentage: type: number example: 19 type: type: string enum: - RECEIVE - RECEIVE-OVERPAYMENT - RECEIVE-PREPAYMENT - SPEND - SPEND-OVERPAYMENT - SPEND-PREPAYMENT - RECEIVE-TRANSFER - SPEND-TRANSFER example: SPEND valueDate: type: string example: '2025-07-15T00:00:00Z' BaseResponseDto: type: object properties: meta: $ref: '#/components/schemas/MetaResponse' data: oneOf: - type: object - type: array TransactionResponseDto: type: object properties: id: type: string example: f733a433-9662-4a40-8e36-e38ebda94fe1 accountId: type: string example: 14a6b5e92-a261-4be9-814d-84dec9636c16 accountNumber: type: number example: 4900 amount: type: number example: 100 bookingDate: type: string example: '2025-07-15T00:00:00Z' contact: type: string example: eaa28f49-6028-4b6e-bb12-d8f6278073fc currency: type: string enum: - AED - AFN - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BRL - BSD - BTN - BWP - BYR - BZD - CAD - CDF - CHF - CLP - CNY - COP - CRC - CUC - CVE - CZK - DJF - DKK - DOP - DZD - EEK - EGP - ERN - ETB - EUR - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GQE - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - INR - IQD - IRR - ISK - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LTL - LVL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRO - MUR - MVR - MWK - MXN - MYR - MZM - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - SAR - SBD - SCR - SDG - SEK - SGD - SHP - SLL - SOS - SRD - SYP - SZL - THB - TJS - TMT - TND - TRY - TTD - TWD - TZS - UAH - UGX - USD - UYU - UZS - VEB - VND - VUV - WST - XAF - XCD - XDR - XOF - XPF - YER - ZAR - ZMK - ZWR example: EUR description: type: string example: Hotel for dreamforce files: type: array items: type: string example: file1.pdf journalCode: type: string example: '31' ledgerName: type: string example: Payroll reference: type: string example: RCXF197253F status: type: string enum: - CREATED - LINKED - PRIVATE - BOOKED - AUTHORISED - DELETED example: CREATED taskId: type: string example: ADB4457839PXTC2220 taxRatePercentage: type: number example: 19 type: type: string enum: - RECEIVE - RECEIVE-OVERPAYMENT - RECEIVE-PREPAYMENT - SPEND - SPEND-OVERPAYMENT - SPEND-PREPAYMENT - RECEIVE-TRANSFER - SPEND-TRANSFER example: SPEND valueDate: type: string example: '2025-07-15T00:00:00Z' MetaResponse: type: object properties: warnings: type: array items: type: string example: Field not used by target system pagination: $ref: '#/components/schemas/PaginationResponse' PaginationResponse: type: object properties: total: type: number example: 125 perPage: type: number example: 50 currentPage: type: number example: 1 totalPages: type: number example: 3 ````