---
title: "Create a Transaction"
method: POST
path: "/v3/transactions"
tags: ["Transaction (v3)"]
---

# Create a Transaction

`POST /v3/transactions`

Creates a Transaction using the v3 API format. Either a `message` or `summary` must be provided, but not both. For guidance on how to use this endpoint, see the <a href="https://docs.orderful.com/docs/create-a-transaction" target="_blank">Create a Transaction guide</a>.

## Headers

- `orderful-api-key` string, required

## Request body

- CreateTransactionBodyV3 — Request body for creating a v3 transaction.
  - `type` CreateTransactionBodyTypeV3Dto, required
    - `name` string, required — The type of Transaction to be created. Please refer to our <a href="https://docs.orderful.com/reference/available-transaction-types" target="_blank">list of available Transaction Types</a>.
  - `stream` 'TEST' | 'LIVE', required — Name of stream to create the transaction on.
  - `message` string, json — Transaction document in the structure defined by the specified type. Either message or summary must be provided, but not both.
  - `sender` CreateTransactionBodyIdentityV3Dto, required
    - `isaId` string, required — The unique ISA identifier.
  - `receiver` CreateTransactionBodyIdentityV3Dto, required
    - `isaId` string, required — The unique ISA identifier.

## Response `201`

Transaction created successfully.

- CreateTransactionResponseV3
  - `id` string, required — The transaction ID.

## Other responses

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

---

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