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:
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" }