---
title: "Create account connection"
method: POST
path: "/v2/account-connections"
tags: ["Account Connections"]
---

# Create account connection

`POST /v2/account-connections`

Stores connection credentials for later use in preview and sync. For multisig providers (safe, squads, realms), an address that fails to resolve returns a classified error body `{ statusCode, error, code, message }` with `code` one of: `invalid_address` (bad format), `multisig_not_found` (well-formed address, no multisig there), `wrong_network` (Safe only — exists, but on a different chain than selected), `upstream_unavailable` (the provider/RPC failed — transient, safe to retry).

## Request body

- CreateAccountConnectionDto
  - `name` string, required
  - `type` object, required
  - `utila` CreateAccountConnectionUtilaCredentialsDto
    - `service_account_email` string, required
  - `kraken` CreateAccountConnectionKrakenCredentialsDto
    - `api_key` string, required
    - `api_secret` string, required
  - `binance` CreateAccountConnectionBinanceCredentialsDto
    - `api_key` string, required — Binance API key (read-only)
    - `api_secret` string, required — Binance API secret (read-only)
  - `okx` CreateAccountConnectionOkxCredentialsDto
    - `api_key` string, required — OKX API key (read-only)
    - `api_secret` string, required — OKX API secret
    - `passphrase` string, required — Passphrase set when creating the API key
  - `bybit` CreateAccountConnectionBybitCredentialsDto
    - `api_key` string, required — Bybit API key (read-only)
    - `api_secret` string, required — Bybit API secret
  - `bitget` CreateAccountConnectionBitgetCredentialsDto
    - `api_key` string, required — Bitget API key (read-only)
    - `api_secret` string, required — Bitget API secret
    - `passphrase` string, required — Passphrase set when creating the API key
  - `gate` CreateAccountConnectionGateCredentialsDto
    - `api_key` string, required — Gate.io APIv4 key (read-only)
    - `api_secret` string, required — Gate.io APIv4 secret
  - `kucoin` CreateAccountConnectionKucoinCredentialsDto
    - `api_key` string, required — KuCoin API key (read-only, General only)
    - `api_secret` string, required — KuCoin API secret
    - `passphrase` string, required — Passphrase set when creating the API key
    - `api_key_version` object — API key version from KuCoin's API Management page. Defaults to '3' (current generation).
  - `plaid` CreateAccountConnectionPlaidCredentialsDto
    - `public_token` string, required
  - `squads` CreateAccountConnectionSquadsCredentialsDto
    - `address` string, required
  - `altitude` CreateAccountConnectionAltitudeCredentialsDto
    - `address` string, required — Altitude (Squads smart account) address — either the deposit address or its Settings account.
  - `coinbase` CreateAccountConnectionCoinbaseCredentialsDto
    - `key_id` string, required
    - `private_key` string, required
  - `realms` CreateAccountConnectionRealmsCredentialsDto
    - `address` string, required
  - `safe` CreateAccountConnectionSafeCredentialsDto
    - `address` string, required — EVM Safe address
    - `network` 'ethereum' | 'arbitrum' | 'base' | 'optimism' | 'polygon' | 'bnb', required
  - `wise` CreateAccountConnectionWiseCredentialsDto
    - `api_token` string, required
    - `profile_id` string, required
  - `hyperliquid` CreateAccountConnectionHyperliquidCredentialsDto
    - `address` string, required
  - `cubist` CreateAccountConnectionCubistCredentialsDto
    - `login_id` string
    - `refresh_token` string
    - `org_id` string
    - `environment` object
  - `anchorage` CreateAccountConnectionAnchorageCredentialsDto
    - `api_access_key` string, required
  - `privy` CreateAccountConnectionPrivyCredentialsDto
    - `app_id` string, required
    - `app_secret` string, required
  - `dfns` CreateAccountConnectionDfnsCredentialsDto
    - `token` string, required — Dfns service account token
    - `base_url` string — Dfns API host. Must be an official Dfns cluster: https://api.dfns.io (default) or https://api.uae.dfns.io for UAE-hosted orgs.
  - `revolut_business` CreateAccountConnectionRevolutBusinessCredentialsDto
    - `client_id` string, required
    - `refresh_token` string, required — Revolut OAuth refresh token
    - `private_key_pem` string, required — RSA private key (PEM) matching the uploaded API certificate
    - `iss` string, required — JWT `iss` — the redirect URI host used when the certificate was created
    - `environment` 'sandbox' | 'production'
  - `turnkey` CreateAccountConnectionTurnkeyCredentialsDto
    - `api_private_key` string, required — Turnkey API private key (32-byte hex scalar)
    - `api_public_key` string, required — Turnkey API public key (compressed hex)
    - `organization_id` string, required — Turnkey organization id
  - `octav` CreateAccountConnectionOctavCredentialsDto
    - `api_key` string, required — The user's own Octav API key
    - `addresses` string[], required — EVM wallet addresses to track protocol positions for

## Response `200`

- AccountConnectionDto
  - `id` string, required
  - `name` string, required
  - `type` 'utila' | 'kraken' | 'binance' | 'okx' | 'bybit' | 'bitget' | 'gate' | 'kucoin' | 'plaid' | 'squads' | 'altitude' | 'coinbase' | 'realms' | 'wise' | 'safe' | 'hyperliquid' | 'cubist' | 'privy' | 'dfns' | 'anchorage' | 'revolut_business' | 'turnkey' | 'octav', required
  - `public_data` object, required — Non-sensitive public metadata
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

---

[API](https://skmtc.net/range/apis/range-platform-api.md) · [All operations](https://skmtc.net/range/apis/range-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/range/range-platform-api/versions/9926df2e476d/schema)