---
title: "Create a linked account"
method: POST
path: "/linked-accounts"
tags: ["Linked accounts"]
---

# Create a linked account

`POST /linked-accounts`

Bank account numbers are stored and returned masked (last four digits only).

## Request body

- union
  - object
    - `type` 'bank', required
    - `name` string, required
    - `bankName` string
    - `routingNumber` string, required
    - `accountNumber` string, required
    - `accountType` 'checking' | 'savings'
  - object
    - `type` 'wallet', required
    - `name` string, required
    - `walletAddress` string, required
    - `network` 'base' | 'base-sepolia' | 'arc' | 'solana', required

## Response `201`

The created linked account

- object
  - `linkedAccount` object, required
    - `id` string, required
    - `name` string, required
    - `type` 'bank' | 'wallet', required
    - `verificationStatus` 'verified' | 'pending' | 'failed', required
    - `createdAt` string, required
    - `bankName` string
    - `routingNumber` string
    - `accountNumber` string
    - `accountType` 'checking' | 'savings'
    - `walletAddress` string
    - `network` 'base' | 'base-sepolia' | 'arc' | 'solana'

---

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