---
title: "POST /v1/portfolios/{portfolioSlug}/transaction-imports"
method: POST
path: "/v1/portfolios/{portfolioSlug}/transaction-imports"
tags: ["TransactionImports"]
---

# POST /v1/portfolios/{portfolioSlug}/transaction-imports

`POST /v1/portfolios/{portfolioSlug}/transaction-imports`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/portfolios/{portfolioSlug}/transaction-imports`
- Auth: API key in header `x-api-key`

## Path parameters

- `portfolioSlug` string, required

## Request body

- StartTransactionImportRequestDto
  - `contentBase64` string, required: Tabular source file content as base64-encoded bytes (max 5 MB)
  - `fileName` string, required
  - `integrationId` string, required
  - `target` union, required
    - object
      - `declaredAddress` string
      - `declaredName` string
      - `kind` 'new', required
    - object
      - `kind` 'existing', required
      - `wallet` object, required
        - `chainId` string, required: Chain ID
        - `walletAddress` string, required: Wallet address

## Response `201`

- StartTransactionImportResponseDto
  - `importRef` string, required: Public transaction import reference
  - `jobId` string, required
  - `status` 'UPLOADED' | 'ANALYZING' | 'PREVIEW_READY' | 'FINALIZING' | 'COMMITTED' | 'FAILED' | 'DELETED', required

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)