Ctrl+K

Create Network Partner

post/api/network/v1/admin/partners

Create a new OES partner. This admin-only endpoint allows BitGo administrators to create new partners in the system with additional configuration options beyond what is available through the enterprise partner creation endpoint.

Query Parameters

  • trustOrgstringRequired
    Trust organization identifier. Used for filtering by the trust organization the partner belongs to.
    Enum: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland BitGo Europe ApS Frankfurt DE Trust BitGo Singapore BitGo Korea BitGo Custody MENA FZE BitGo India BitGo Sister Trust 1

Request Body

name string required
The name of the partner. This will be displayed in the UI.
Min length: >= 1 characters
broker boolean required
Indicates whether the partner is a broker. If true, the partner can facilitate trading between clients. If false, the partner acts as an exchange with its own trading accounts.
institutionId string
Optional UUID for the partner's institution record. Links the partner to an institution in the BitGo system.
institutionIdentifier string required
External identifier for the partner's institution. Provides an alternative way to identify the institution.
Min length: >= 1 characters
connectionKeySchema string required
The key schema used for partner connections. Defines the structure and validation rules for connection keys.
Allowed values: token tokenAndSignature apiKeyAndSecret clearloop
clientDisputeWindowMinutes number
Optional window (in minutes) for clients to dispute settlements. Defines how long after a settlement clients have to raise disputes. Null means no dispute window is configured.
topUpWindowMinutes number
Optional window (in minutes) for topping up settlements. Defines the period during which a settlement can be topped up. Null means no top-up window is configured.
allocationPoliciesEnabled boolean
Optional flag to enable or disable allocation policies for the partner. When true, policy evaluation features (allocation/deallocation) are enabled. When false or not provided, defaults to false for backward compatibility.
enterpriseId string required
The enterprise identifier for the partner being created. This identifies which enterprise will own the partner record.
Min length: >= 1 characters

200 Response

partner object required
The complete partner object that was successfully created.
id string required
enterpriseId string required
Min length: >= 1 characters
trustOrg string required
Allowed values: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland BitGo Europe ApS Frankfurt DE Trust BitGo Singapore BitGo Korea BitGo Custody MENA FZE BitGo India BitGo Sister Trust 1
institutionId string
institutionIdentifier string required
Min length: >= 1 characters
name string required
Min length: >= 1 characters
connectionKeySchema string required
Allowed values: token tokenAndSignature apiKeyAndSecret clearloop
createdAt string <date-time>required
Timestamp when the partner was created in the system.
updatedAt string <date-time>required
Timestamp of the most recent update to the partner record.
clientId string required
broker boolean required
active boolean required
settlementTransactionRouteId string
clientDisputeWindowMinutes number
topUpWindowMinutes number
allocationPoliciesEnabled boolean required
publicKey string
Optional RSA public key associated with the partner. This key is used for secure communication and encrypting connection keys. If not supplied, encryption is not required for the partner.

400 Response

401 Response

error string required

403 Response

error string required

422 Response

error string required

500 Response

error string required