Sign in

v1

latestOpenAPI 3.0.02026-07-26117198177.4 KB
Account Connections

Create account connection

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).

post/v2/account-connections

Request body

namestring required
typeobject required

Example request

{
  "altitude": {
    "address": "H8sdnTKCRKiyrDT8g9pMTzeoihUcEoTNdybakNT81xyQ"
  },
  "safe": {
    "address": "0xAbCd...1234",
    "network": "ethereum"
  },
  "dfns": {
    "base_url": "https://api.dfns.io"
  },
  "revolut_business": {
    "client_id": "zfTKV9Eie_...",
    "iss": "example.com",
    "environment": "production"
  },
  "octav": {
    "addresses": [
      "0x253bef0EE4ab6b539D8D5E9e28Ad05C1e952dBf6"
    ]
  }
}

Response

idstring required
namestring 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_dataobject required

Non-sensitive public metadata

created_atstring date-time required
updated_atstring date-time required

Example response

{
  "id": "conn_abc123",
  "name": "My Utila Account",
  "type": "utila",
  "public_data": {
    "public_key": "pk_abc123"
  },
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z"
}