---
updatedAt: 2025-10-24T06:29:36.000Z
agentTools:
  projectIndex: https://developer.integrated.finance/llms.txt
---

# Create a Generic Transaction

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Generic Transaction API",
    "description": "Operations for Generic Transactions",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://sandbox-api.integrated.finance/v1/{instanceId}",
      "description": "Sandbox",
      "variables": {}
    },
    {
      "url": "https://api.integrated.finance/v1/{instanceId}",
      "description": "Production",
      "variables": {}
    }
  ],
  "paths": {
    "/generic-transactions": {
      "post": {
        "tags": [
          "Generic Transactions"
        ],
        "summary": "Create a Generic Transaction",
        "operationId": "generic-transactions.create",
        "requestBody": {
          "content": {
            "*/*": {
              "schema": {
                "$ref": "#/components/schemas/GenericTransactionCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Generic transaction created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GenericTransactionCreateResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AttributeMap": {
        "type": "object",
        "description": "Generic Transaction Attributes"
      },
      "GenericTransactionCreateConnectContainer": {
        "type": "object",
        "description": "connect container"
      },
      "GenericTransactionCreateDataContainer": {
        "required": [
          "genericTransaction"
        ],
        "type": "object",
        "properties": {
          "genericTransaction": {
            "$ref": "#/components/schemas/GenericTransactionResource"
          },
          "narrative": {
            "$ref": "#/components/schemas/NarrativeWorkflowDataInput"
          }
        },
        "description": "generic transaction data container"
      },
      "GenericTransactionCreateMetadataContainer": {
        "type": "object",
        "description": "metadata container"
      },
      "GenericTransactionCreateResponse": {
        "required": [
          "connect",
          "data",
          "metadata",
          "workflow"
        ],
        "type": "object",
        "properties": {
          "workflow": {
            "$ref": "#/components/schemas/OutgoingTransferCreateWorkflowContainer"
          },
          "data": {
            "$ref": "#/components/schemas/GenericTransactionCreateDataContainer"
          },
          "connect": {
            "$ref": "#/components/schemas/GenericTransactionCreateConnectContainer"
          },
          "metadata": {
            "$ref": "#/components/schemas/GenericTransactionCreateMetadataContainer"
          }
        },
        "description": "response model"
      },
      "GenericTransactionResource": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "ID of generic transaction",
            "format": "uuid"
          },
          "type": {
            "type": "string",
            "description": "type"
          },
          "owner": {
            "$ref": "#/components/schemas/Owner"
          },
          "clientId": {
            "type": "string",
            "description": "id of client",
            "format": "uuid"
          },
          "accountId": {
            "type": "string",
            "description": "id of account",
            "format": "uuid"
          },
          "transactionNumber": {
            "type": "string",
            "description": "transaction number"
          },
          "amount": {
            "type": "number",
            "description": "transaction amount"
          },
          "currency": {
            "type": "string",
            "description": "transaction currency"
          },
          "status": {
            "$ref": "#/components/schemas/GenericTransactionStatus"
          },
          "attributes": {
            "$ref": "#/components/schemas/AttributeMap"
          },
          "narrative": {
            "type": "string",
            "description": "Generic Transaction Narrative"
          },
          "creationDateTime": {
            "type": "string",
            "description": "Generic Transaction Creation Date Time",
            "format": "date-time"
          }
        },
        "description": "generic transaction model",
        "readOnly": true
      },
      "GenericTransactionStatus": {
        "type": "string",
        "description": "Generic Transaction Status",
        "enum": [
          "completed"
        ]
      },
      "InformationSourcingMethod": {
        "type": "string",
        "description": "configures where the information for narrative will be sourced",
        "enum": [
          "explicit",
          "implicit"
        ]
      },
      "NarrativeWorkflowConfiguration": {
        "type": "object",
        "properties": {
          "sourcingMethod": {
            "$ref": "#/components/schemas/InformationSourcingMethod"
          },
          "enabled": {
            "type": "boolean",
            "description": "determines whether narrative will be applied or not"
          }
        },
        "description": "narrative workflow context"
      },
      "NarrativeWorkflowDataInput": {
        "type": "object",
        "properties": {
          "template": {
            "type": "string",
            "description": "template of narrative"
          }
        },
        "description": "narrative workflow data input"
      },
      "OutgoingTransferCreateWorkflowContainer": {
        "required": [
          "code",
          "narrative"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "workflow code",
            "enum": [
              "direct",
              "client.direct",
              "organization.direct"
            ]
          },
          "narrative": {
            "$ref": "#/components/schemas/NarrativeWorkflowConfiguration"
          }
        },
        "description": "workflow container"
      },
      "Owner": {
        "type": "string",
        "description": "owner of generic transaction",
        "enum": [
          "organization",
          "client"
        ]
      },
      "GenericTransactionCreateRequest": {
        "required": [
          "connect",
          "data",
          "metadata",
          "workflow"
        ],
        "type": "object",
        "properties": {
          "workflow": {
            "$ref": "#/components/schemas/OutgoingTransferCreateWorkflowContainer"
          },
          "data": {
            "$ref": "#/components/schemas/GenericTransactionCreateDataContainer"
          },
          "connect": {
            "$ref": "#/components/schemas/GenericTransactionCreateConnectContainer"
          },
          "metadata": {
            "$ref": "#/components/schemas/GenericTransactionCreateMetadataContainer"
          }
        },
        "description": "request model"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```