---
title: "Create leg (term)"
method: POST
path: "/smart-transfers/{ticketId}/terms"
tags: ["Smart Transfer"]
---

# Create leg (term)

`POST /smart-transfers/{ticketId}/terms`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/smart-transfers/{ticketId}/terms`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/smart-transfers/:ticketId/terms/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates new smart transfer ticket term (when the ticket status is DRAFT). Learn more about Fireblocks Smart Transfers in the following [guide](https://developers.fireblocks.com/docs/execute-smart-transfers). Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor.

## Path parameters

- `ticketId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- SmartTransferCreateTicketTerm
  - `asset` string, required: Asset name
  - `amount` string, required: Amount
  - `fromNetworkId` string, required: Identifier of the origination Network Profile
  - `toNetworkId` string, required: Identifier of the destination Network Profile

## Response `201`

Smart Transfer ticket term was created successfully

- SmartTransferTicketTermResponse
  - `message` string, nullable, required: Result message
  - `data` SmartTransferTicketTerm, nullable: Data object with result data
    - `id` string, required: Unique id of Smart Transfer ticket term
    - `ticketId` string, required: Unique id of Smart Transfer ticket
    - `asset` string, required: Asset name
    - `amount` string, required: Amount
    - `dvpSrcDstVaultId` string: Identifier of the source and destination vault for DVP execution
    - `amountUsd` string: Amount USD
    - `fromNetworkId` string, required: Identifier of the origination Network Profile
    - `fromNetworkIdName` string, required: Source network name
    - `toNetworkId` string, required: Identifier of the destination Network Profile
    - `toNetworkIdName` string, required: Destination network name
    - `txHash` string, nullable, required: Blockchain TX hash
    - `fbTxId` string, nullable, required: Fireblocks transaction ID. It is set when the funding transaction is created.
    - `txStatus` 'queued' | 'submitted' | 'pendingSignature' | 'pendingAuthorization' | 'broadcasting' | 'confirming' | 'pendingAmlScreening' | 'completed' | 'cancelled' | 'failed' | 'rejected' | 'blocked' | 'thirdPartyPendingManualApproval' | 'thirdPartyPending' | 'partiallyCompleted' | 'cancelling', nullable, required: Ticket term transaction status
    - `status` 'CREATED' | 'FUNDING' | 'FUNDING_FAILED' | 'FUNDED' | 'REJECTED', required: Ticket term status
    - `createdAt` string, date-time, required: Date and time when the term is created.
    - `updatedAt` string, date-time, required: Date and time of last term update.

## Other responses

- `403`: Unauthorized
- `422`: Bad Request

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)