---
title: "Creates a new Bitcoin transaction"
method: POST
path: "/createAction"
tags: ["HTTPWalletJSON"]
---

# Creates a new Bitcoin transaction

`POST /createAction`

## Request body

- CreateActionArgs
  - `description` string
  - `inputBEEF` number[]
  - `inputs` CreateActionInput[]
    - `outpoint` string
    - `inputDescription` string
    - `unlockingScript` string
    - `unlockingScriptLength` number
    - `sequenceNumber` number
  - `outputs` CreateActionOutput[]
    - `lockingScript` string
    - `satoshis` number
    - `outputDescription` string
    - `basket` string
    - `customInstructions` string
    - `tags` string[]
  - `lockTime` number
  - `version` number
  - `labels` string[]
  - `options` CreateActionOptions
    - `signAndProcess` boolean
    - `acceptDelayedBroadcast` boolean
    - `trustSelf` 'known'
    - `knownTxids` string[]
    - `returnTXIDOnly` boolean
    - `noSend` boolean
    - `noSendChange` string[]
    - `sendWith` string[]
    - `randomizeOutputs` boolean

## Response `200`

The created transaction result

- CreateActionResult
  - `txid` string
  - `tx` number[]
  - `noSendChange` string[]
  - `sendWithResults` SendWithResult[]
    - `txid` string
    - `status` 'unproven' | 'sending' | 'failed'
  - `signableTransaction` SignableTransaction
    - `tx` number[]
    - `reference` string

## Other responses

- `400` — Invalid input
- `500` — Internal server error

---

[API](https://skmtc.dev/bsv-blockchain/apis/wallet-json-api.md) · [All operations](https://skmtc.dev/bsv-blockchain/apis/wallet-json-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bsv-blockchain/wallet-json-api/revisions/4b04a6edb128/schema)