---
title: "Create a new Web3 connection."
method: POST
path: "/connections/wc"
tags: ["Web3 connections"]
---

# Create a new Web3 connection.

`POST /connections/wc`

## Request

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

Initiate a new Web3 connection.

* Note: After this succeeds, make a request to `PUT /v1/connections/wc/{id}` (below) to approve or reject the new Web3 connection.

## Headers

- `Idempotency-Key` string
- `X-End-User-Wallet-Id` string, uuid

## Request body

- union
  - CreateVaultAccountConnectionRequest
    - `vaultAccountId` number, required: The ID of the vault to connect to the dApp.
    - `feeLevel` 'MEDIUM' | 'HIGH', required: The default fee level. Valid values are `MEDIUM` and `HIGH`.
    - `uri` string, required: The WalletConnect uri provided by the dapp.
    - `chainIds` string[]: The IDs of the blockchain networks used in the Web3 connection (Currently required in V1 connections only).
  - CreateNcwConnectionRequest
    - `ncwId` string, required: The ID of the Non-Custodial Wallet to connect to the dApp.
    - `ncwAccountId` number, required: The NCW account ID to connect to the dApp.
    - `feeLevel` 'MEDIUM' | 'HIGH', required: The default fee level. Valid values are `MEDIUM` and `HIGH`.
    - `uri` string, required: The WalletConnect uri provided by the dapp.
    - `chainIds` string[]: The IDs of the blockchain networks used in the Web3 connection (Currently required in V1 connections only).

## Response `201`

Web3 connection initiated successfully

- CreateConnectionResponse
  - `id` string, required: The ID of the Web3 connection initiated.
  - `sessionMetadata` SessionMetadata, required
    - `appUrl` string, required
    - `appName` string
    - `appDescription` string
    - `appIcon` string

## Other responses

- `400`: Invalid data sent
- `500`: Something went wrong

---

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