> ## Documentation Index > Fetch the complete documentation index at: https://docs.range.org/llms.txt > Use this file to discover all available pages before exploring further. # Create account, ledger, risk or travel-rule connection > Stores connection credentials. Account providers support preview/import; ledger providers (e.g. quickbooks, xero) store OAuth tokens only; risk providers (merkle_science, chainalysis) store a BYO screening key, at most one per workspace: a merkle_science key is verified against the vendor before it is stored; a chainalysis key is stored with `public_data.key_status` `unverified` and settled by its first real screen; travel-rule providers (notabene) store OAuth client credentials and an entity DID, verified against the vendor before they are stored, at most one per workspace. 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). ## OpenAPI ````yaml /api-reference/platform-api.json post /v2/account-connections openapi: 3.0.0 info: title: Range Platform API description: >- The Range Platform API for workspace management, counterparties, and operational tooling. version: 1.7.32 contact: {} servers: - url: https://api.range.org description: Range API Server security: - Authorization: [] - Authorization: [] tags: - name: Address Information description: Get information about a crypto address. - name: Transfer Enrichments description: Attach workspace-scoped notes and categories to transfers. - name: Counterparties description: Manage external entities, their addresses, bank accounts, and documents. - name: Parties description: >- The workspace entity register: the firm itself, its clients, and its counterparties. paths: /v2/account-connections: post: tags: - Account Connections summary: Create account, ledger, risk or travel-rule connection description: >- Stores connection credentials. Account providers support preview/import; ledger providers (e.g. quickbooks, xero) store OAuth tokens only; risk providers (merkle_science, chainalysis) store a BYO screening key, at most one per workspace: a merkle_science key is verified against the vendor before it is stored; a chainalysis key is stored with `public_data.key_status` `unverified` and settled by its first real screen; travel-rule providers (notabene) store OAuth client credentials and an entity DID, verified against the vendor before they are stored, at most one per workspace. 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). operationId: createConnection parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateAccountConnectionDto' responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/AccountConnectionDto' components: schemas: CreateAccountConnectionDto: type: object properties: name: type: string type: type: object enum: - utila - kraken - binance - okx - bybit - bitget - gate - kucoin - plaid - squads - altitude - coinbase - realms - wise - safe - hyperliquid - cubist - privy - dfns - anchorage - revolut_business - turnkey - fordefi - coins_ph - fireblocks - pave_bank - meow - copper - custom - quickbooks - xero - merkle_science - chainalysis - notabene utila: $ref: '#/components/schemas/CreateAccountConnectionUtilaCredentialsDto' kraken: $ref: '#/components/schemas/CreateAccountConnectionKrakenCredentialsDto' binance: $ref: '#/components/schemas/CreateAccountConnectionBinanceCredentialsDto' okx: $ref: '#/components/schemas/CreateAccountConnectionOkxCredentialsDto' bybit: $ref: '#/components/schemas/CreateAccountConnectionBybitCredentialsDto' bitget: $ref: '#/components/schemas/CreateAccountConnectionBitgetCredentialsDto' gate: $ref: '#/components/schemas/CreateAccountConnectionGateCredentialsDto' kucoin: $ref: '#/components/schemas/CreateAccountConnectionKucoinCredentialsDto' plaid: $ref: '#/components/schemas/CreateAccountConnectionPlaidCredentialsDto' squads: $ref: '#/components/schemas/CreateAccountConnectionSquadsCredentialsDto' altitude: $ref: '#/components/schemas/CreateAccountConnectionAltitudeCredentialsDto' coinbase: $ref: '#/components/schemas/CreateAccountConnectionCoinbaseCredentialsDto' realms: $ref: '#/components/schemas/CreateAccountConnectionRealmsCredentialsDto' safe: $ref: '#/components/schemas/CreateAccountConnectionSafeCredentialsDto' wise: $ref: '#/components/schemas/CreateAccountConnectionWiseCredentialsDto' hyperliquid: $ref: >- #/components/schemas/CreateAccountConnectionHyperliquidCredentialsDto cubist: $ref: '#/components/schemas/CreateAccountConnectionCubistCredentialsDto' anchorage: $ref: '#/components/schemas/CreateAccountConnectionAnchorageCredentialsDto' privy: $ref: '#/components/schemas/CreateAccountConnectionPrivyCredentialsDto' dfns: $ref: '#/components/schemas/CreateAccountConnectionDfnsCredentialsDto' revolut_business: $ref: >- #/components/schemas/CreateAccountConnectionRevolutBusinessCredentialsDto turnkey: $ref: '#/components/schemas/CreateAccountConnectionTurnkeyCredentialsDto' quickbooks: $ref: '#/components/schemas/CreateAccountConnectionQuickbooksCredentialsDto' merkle_science: $ref: >- #/components/schemas/CreateAccountConnectionMerkleScienceCredentialsDto chainalysis: $ref: >- #/components/schemas/CreateAccountConnectionChainalysisCredentialsDto notabene: $ref: '#/components/schemas/CreateAccountConnectionNotabeneCredentialsDto' xero: $ref: '#/components/schemas/CreateAccountConnectionXeroCredentialsDto' fordefi: $ref: '#/components/schemas/CreateAccountConnectionFordefiCredentialsDto' coins_ph: $ref: '#/components/schemas/CreateAccountConnectionCoinsPhCredentialsDto' fireblocks: $ref: '#/components/schemas/CreateAccountConnectionFireblocksCredentialsDto' pave_bank: $ref: '#/components/schemas/CreateAccountConnectionPaveBankCredentialsDto' meow: $ref: '#/components/schemas/CreateAccountConnectionMeowCredentialsDto' copper: $ref: '#/components/schemas/CreateAccountConnectionCopperCredentialsDto' required: - name - type AccountConnectionDto: type: object properties: id: type: string example: conn_abc123 name: type: string example: My Utila Account type: type: string example: utila enum: - utila - kraken - binance - okx - bybit - bitget - gate - kucoin - plaid - squads - altitude - coinbase - realms - wise - safe - hyperliquid - cubist - privy - dfns - anchorage - revolut_business - turnkey - fordefi - coins_ph - fireblocks - pave_bank - meow - copper - custom - quickbooks - xero - merkle_science - chainalysis - notabene provider_display_name: type: string example: Utila description: >- Canonical brand label for `type` (e.g. okx → OKX, plaid → Bank, gate → Gate.io). kind: type: string example: account enum: - account - ledger - risk - travel_rule description: >- Connection family: `account` (import Range Accounts), `ledger` (bookkeeping) or `risk` (BYO risk-provider key). public_data: type: object description: Non-sensitive public metadata additionalProperties: true example: public_key: pk_abc123 created_at: format: date-time type: string example: '2026-01-01T00:00:00.000Z' updated_at: format: date-time type: string example: '2026-01-01T00:00:00.000Z' description: >- Last **config** edit: creation, rename, or a credential/session refresh. Transaction-sync lifecycle lives on accounts (`AccountDto.last_synced_at` / `sync_status`), not on connections. required: - id - name - type - provider_display_name - kind - public_data - created_at - updated_at CreateAccountConnectionUtilaCredentialsDto: type: object properties: service_account_email: type: string required: - service_account_email CreateAccountConnectionKrakenCredentialsDto: type: object properties: api_key: type: string api_secret: type: string required: - api_key - api_secret CreateAccountConnectionBinanceCredentialsDto: type: object properties: api_key: type: string description: Binance API key (read-only) api_secret: type: string description: Binance API secret (read-only) required: - api_key - api_secret CreateAccountConnectionOkxCredentialsDto: type: object properties: api_key: type: string description: OKX API key (read-only) api_secret: type: string description: OKX API secret passphrase: type: string description: Passphrase set when creating the API key required: - api_key - api_secret - passphrase CreateAccountConnectionBybitCredentialsDto: type: object properties: api_key: type: string description: Bybit API key (read-only) api_secret: type: string description: Bybit API secret required: - api_key - api_secret CreateAccountConnectionBitgetCredentialsDto: type: object properties: api_key: type: string description: Bitget API key (read-only) api_secret: type: string description: Bitget API secret passphrase: type: string description: Passphrase set when creating the API key required: - api_key - api_secret - passphrase CreateAccountConnectionGateCredentialsDto: type: object properties: api_key: type: string description: Gate.io APIv4 key (read-only) api_secret: type: string description: Gate.io APIv4 secret required: - api_key - api_secret CreateAccountConnectionKucoinCredentialsDto: type: object properties: api_key: type: string description: KuCoin API key (read-only, General only) api_secret: type: string description: KuCoin API secret passphrase: type: string description: Passphrase set when creating the API key api_key_version: type: object enum: - '2' - '3' description: >- API key version from KuCoin's API Management page. Defaults to '3' (current generation). required: - api_key - api_secret - passphrase CreateAccountConnectionPlaidCredentialsDto: type: object properties: public_token: type: string required: - public_token CreateAccountConnectionSquadsCredentialsDto: type: object properties: address: type: string required: - address CreateAccountConnectionAltitudeCredentialsDto: type: object properties: address: type: string description: >- Altitude (Squads smart account) address — either the deposit address or its Settings account. example: H8sdnTKCRKiyrDT8g9pMTzeoihUcEoTNdybakNT81xyQ required: - address CreateAccountConnectionCoinbaseCredentialsDto: type: object properties: key_id: type: string private_key: type: string required: - key_id - private_key CreateAccountConnectionRealmsCredentialsDto: type: object properties: address: type: string required: - address CreateAccountConnectionSafeCredentialsDto: type: object properties: address: type: string example: 0xAbCd...1234 description: EVM Safe address network: type: string example: ethereum enum: - ethereum - arbitrum - base - optimism - polygon - bnb required: - address - network CreateAccountConnectionWiseCredentialsDto: type: object properties: api_token: type: string profile_id: type: string required: - api_token - profile_id CreateAccountConnectionHyperliquidCredentialsDto: type: object properties: address: type: string required: - address CreateAccountConnectionCubistCredentialsDto: type: object properties: login_id: type: string refresh_token: type: string org_id: type: string environment: type: object enum: - gamma - prod CreateAccountConnectionAnchorageCredentialsDto: type: object properties: api_access_key: type: string required: - api_access_key CreateAccountConnectionPrivyCredentialsDto: type: object properties: app_id: type: string app_secret: type: string required: - app_id - app_secret CreateAccountConnectionDfnsCredentialsDto: type: object properties: token: type: string description: Dfns service account token base_url: type: string example: https://api.dfns.io description: >- Dfns API host. Must be an official Dfns cluster: https://api.dfns.io (default) or https://api.uae.dfns.io for UAE-hosted orgs. required: - token CreateAccountConnectionRevolutBusinessCredentialsDto: type: object properties: client_id: type: string example: zfTKV9Eie_... refresh_token: type: string description: Revolut OAuth refresh token private_key_pem: type: string description: RSA private key (PEM) matching the uploaded API certificate iss: type: string example: example.com description: >- JWT `iss` — the redirect URI host used when the certificate was created environment: type: string enum: - sandbox - production example: production required: - client_id - refresh_token - private_key_pem - iss CreateAccountConnectionTurnkeyCredentialsDto: type: object properties: api_private_key: type: string description: Turnkey API private key (32-byte hex scalar) api_public_key: type: string description: Turnkey API public key (compressed hex) organization_id: type: string description: Turnkey organization id required: - api_private_key - api_public_key - organization_id CreateAccountConnectionQuickbooksCredentialsDto: type: object properties: code: type: string description: Authorization code from the Intuit OAuth redirect realm_id: type: string description: QuickBooks company (realm) id from the OAuth redirect example: '1234567890' state: type: string description: >- CSRF state returned by POST /account-connections/quickbooks/authorize-url required: - code - realm_id - state CreateAccountConnectionMerkleScienceCredentialsDto: type: object properties: api_key: type: string maxLength: 256 description: >- Merkle Science Compass API key (sent as X-API-KEY). Verified against GET /blockchains/ before it is stored. required: - api_key CreateAccountConnectionChainalysisCredentialsDto: type: object properties: api_key: type: string maxLength: 256 description: >- Chainalysis Address Screening (Entity Risking API) token, sent as the Token header. Stored without a vendor call as `public_data.key_status` `unverified`; the first real screen marks it `verified` or `rejected`. required: - api_key CreateAccountConnectionNotabeneCredentialsDto: type: object properties: client_id: type: string maxLength: 256 description: Notabene API client id (Settings → API credentials) client_secret: type: string maxLength: 512 description: Notabene API client secret entity_did: type: string maxLength: 512 description: >- The workspace's own Notabene entity DID (e.g. did:web:vasps.id:example). Every transfer read is scoped to it. node: type: string enum: - eu1 - us1 description: >- Notabene node the account lives on (selects the API and token URLs). No default: a wrong node fails authentication. required: - client_id - client_secret - entity_did - node CreateAccountConnectionXeroCredentialsDto: type: object properties: code: type: string description: >- Authorization code from the Xero redirect. Omit when retrying a multi-organisation connect with tenant_id. state: type: string description: CSRF state returned by POST /account-connections/xero/authorize-url tenant_id: type: string description: >- Xero organisation tenant id. Required when the consent covers more than one organisation. required: - state CreateAccountConnectionFordefiCredentialsDto: type: object properties: api_user_token: type: string description: >- Fordefi API User bearer token, scoped to a read-only / non-signing role required: - api_user_token CreateAccountConnectionCoinsPhCredentialsDto: type: object properties: api_key: type: string description: Coins.ph API key (read-only / USER_DATA) api_secret: type: string description: Coins.ph API secret required: - api_key - api_secret CreateAccountConnectionFireblocksCredentialsDto: type: object properties: api_key: type: string description: Fireblocks API User ID (UUID shown in Console) private_key_pem: type: string description: RSA private key PEM matching the CSR uploaded for this API user region: type: string enum: - us - eu - eu2 - sandbox description: Fireblocks workspace region (selects API base URL) default: us required: - api_key - private_key_pem CreateAccountConnectionPaveBankCredentialsDto: type: object properties: client_id: type: string description: Pave Bank OAuth client id client_secret: type: string description: Pave Bank OAuth client secret environment: type: string enum: - production - sandbox description: Pave Bank API environment (selects API base URL) default: production required: - client_id - client_secret CreateAccountConnectionMeowCredentialsDto: type: object properties: api_key: type: string description: Meow API key (read scopes only) entity_id: type: string description: >- Meow entity id. Sent as x-entity-id. Required when the key can access more than one entity. environment: type: string enum: - production - sandbox description: Meow API environment (selects API base URL) default: production required: - api_key CreateAccountConnectionCopperCredentialsDto: type: object properties: api_key: type: string description: Copper Platform API key api_secret: type: string description: Copper Platform API secret environment: type: string enum: - production - demo - testnet description: Copper API environment (selects API base URL) default: production required: - api_key - api_secret securitySchemes: Authorization: type: apiKey in: header name: X-API-KEY description: Authorization method required to allow user to access the api endpoints. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.