---
title: "Create a new network connection"
method: POST
path: "/network_connections"
tags: ["Network connections"]
---

# Create a new network connection

`POST /network_connections`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/network_connections`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/network_connections/post.ts> (a function with typed inputs; its response is checked against the schema)

Initiates a new network connection.
**Note:** This API call is subject to Flexible Routing Schemes.

Your routing policy defines how your transactions are routed.
You can choose 1 of the 3 different schemes mentioned below for each asset type:
  - **None**; Defines the profile routing to no destination for that asset type. Incoming transactions to asset types routed to `None` will fail.
  - **Custom**; Route to an account that you choose. If you remove the account, incoming transactions will fail until you choose another one.
  - **Default**; Use the routing specified by the network profile the connection is connected to. This scheme is also referred to as "Profile Routing"

Default Workspace Presets:
  - Network Profile Crypto → **Custom**
  - Network Profile FIAT → **None**
  - Network Connection Crypto → **Default**
  - Network Connection FIAT → **Default**

Supported asset groups for routing police can be found at `/network_ids/routing_policy_asset_groups`

    - **Note**: By default, Custom routing scheme uses (`dstId` = `0`, `dstType` = `VAULT`).

## Headers

- `Idempotency-Key` string

## Request body

- NetworkConnection
  - `localNetworkId` string, required: The network ID of the profile trying to create the connection.
  - `remoteNetworkId` string, required: The network ID the profile is attempting to connect to.
  - `routingPolicy` NetworkConnectionRoutingPolicy

## Response `201`

A Network Connection object

- NetworkConnectionResponse
  - `id` string, required
  - `localChannel` NetworkChannel: Deprecated in the only used reference - NetworkConnectionResponse
    - `networkId` string
    - `name` string
  - `remoteChannel` NetworkChannel: Deprecated in the only used reference - NetworkConnectionResponse
    - `networkId` string
    - `name` string
  - `status` 'WAITING_FOR_APPROVAL' | 'WAITING_FOR_PEER_APPROVAL' | 'APPROVED' | 'CANCELLED' | 'FAILED' | 'REJECTED' | 'REJECTED_BY_PEER' | 'REMOVED' | 'REMOVED_BY_PEER', required
  - `localNetworkId` NetworkId, required
    - `id` string, required
    - `name` string, required
  - `remoteNetworkId` NetworkId, required
    - `id` string, required
    - `name` string, required
  - `routingPolicy` NetworkConnectionRoutingPolicy, required

## Other responses

- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)