Sign in
Onboarding

Create Partner

Create a new OES Partner. This endpoint allows enterprise users to add themselves as a partner in OES for clients to connect to.

Before calling this endpoint, a configuration for the partner must exist.

If a config is not present for the partner, the request will fail with a 422 error.

To initiate the creation of a partner config, please reach out to the Go Network Engineering team at: go-network-eng@bitgo.com.

Error scenarios:

  • 400: Invalid Request Error

  • Occurs when the request parameters are invalid or incomplete.

  • Examples: Empty string supplied for enterpriseId, invalid connection key schema.

  • 401: Authentication Error

  • Occurs when the request is not authorized.

  • Examples: Caller is not a member of the enterprise.

  • 403: Permission Denied Error

  • Occurs when the authenticated partner doesn't have access to create a partner.

  • Examples: Enterprise does not have OES license.

  • 422: Unprocessable Entity Error

  • Returned when a required partner configuration is missing.

  • Examples: Partner configuration is missing.

  • 500: Internal Server Error

  • Occurs when there's an unexpected error processing the request

  • Examples: Database connection failure, transient network error.

Requires access token scopes: settlement_network_read, settlement_network_write

post/api/network/v1/enterprises/{enterpriseId}/partners

Path parameters

enterpriseIdstring required

The enterprise identifier of the partner. This identifies the partner enterprise making the API request.

Request body

namestring required

The name of the partner. This will be displayed in the UI.

brokerboolean 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.

institutionIdstring

Optional UUID for the partner's institution record. Links the partner to an institution in the BitGo system.

institutionIdentifierstring required

External identifier for the partner's institution. Provides an alternative way to identify the institution.

connectionKeySchema'token' | 'tokenAndSignature' | 'apiKeyAndSecret' | 'clearloop' required
clientDisputeWindowMinutesnumber

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.

topUpWindowMinutesnumber

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.

allocationPoliciesEnabledboolean

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.

Response

OK

Changes

No recorded changes to this endpoint across all 16 revisions of this API.