Ctrl+K

Activate Client Connections

Overview

Clients can connect their Go Network account to their account on your platform. When clients initiate linking their accounts, BitGo sends you a connection request with a connection ID and a client ID.

Clients can create multiple connections to your platform. However you must validate that the client account associated with an API key is a new account with no existing assets. Ensure that you create only 1 connection per client account.

Prerequisites

  • Get Started - Ensure your access token has the following permissions:
    • Settlement Network - Read
    • Settlement Network - Write

Steps

BitGo sends you the following request for each client-initiated connection:

  • API
1
2
3
4
5
6
7
8
9
10
11
12
13
14
POST /bitgo/v1/connections

Request Headers
{
    "X-BitGo-Signature": "string" // X-BitGo-Signature is a signature BitGo provides using a private/public key pair
}

Request Body
{
    "clientId": "UUID",
    "connectionId": "UUID",
    "connectionToken": "string", // connectionToken can be an OTP or unique identifier
    "PartnerId": "UUID",
}

Step Result

1
2
3
4
5
6
{
    "clientId": "UUID",
    "connectionId": "UUID",
    "partnersClientId": "string",
    "partnersConnectionId": "string"
}

Next

Allocate Assets