---
title: "Create a transaction"
method: POST
path: "/v4/transactions"
tags: ["Funds"]
---

# Create a transaction

`POST /v4/transactions`

## Request body

- union
  - CreateAwardedTransactionRequest
    - `transactionStatus` 'awarded' | 'paid' | 'processing' | 'cancelled' | 'pending', required
    - `amount` number, double, required
    - `description` string, nullable
    - `applicantMemo` string, nullable
    - `publicOrganizationId` string, uuid, nullable
  - CreatePendingTransactionRequest
    - `transactionStatus` 'awarded' | 'paid' | 'processing' | 'cancelled' | 'pending', required
    - `amount` number, double, required
    - `description` string, nullable
    - `applicantMemo` string, nullable
    - `publicOrganizationId` string, uuid, nullable
  - CreateProcessingTransactionRequest
    - `transactionStatus` 'awarded' | 'paid' | 'processing' | 'cancelled' | 'pending', required
    - `amount` number, double, required
    - `description` string, nullable
    - `applicantMemo` string, nullable
    - `publicOrganizationId` string, uuid, nullable
  - CreatePaidTransactionRequest
    - `transactionStatus` 'awarded' | 'paid' | 'processing' | 'cancelled' | 'pending', required
    - `amount` number, double, required
    - `description` string, nullable
    - `applicantMemo` string, nullable
    - `publicOrganizationId` string, uuid, nullable

## Response `201`

The new transaction

- TransactionResponse
  - `transactionId` string, uuid, nullable
  - `amount` number, double
  - `fundId` string, uuid, nullable
  - `status` 'awarded' | 'paid' | 'processing' | 'cancelled' | 'pending', nullable
  - `submissionId` string, uuid, nullable
  - `createdAt` string, date-time, nullable
  - `description` string, nullable
  - `applicantMemo` string, nullable
  - `awardTransactionId` string, uuid, nullable

## Other responses

- `400` — Invalid request
- `403` — Insufficient permissions

---

[API](https://skmtc.net/submittable/apis/submittable-api-documentation.md) · [All operations](https://skmtc.net/submittable/apis/submittable-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/submittable/submittable-api-documentation/revisions/254ce50c8212/schema)