REST APILinkLink Accounts

POST

Creates a new account for the given enterprise at the specified venue.

Path Params

  • enterpriseId string required
    Your enterprise id.

    at least 1 characters · matches ^[0-9a-f]{32}$

Header Params

  • user-id string required
    User id of the user making the request.

    at least 1 characters

Body Params

object

New Link Account details
  • venueId string required
    The venue for which the account is being created. This should be a valid venue identifier returned by the GET /venues endpoint.

    at least 1 characters

  • credentials array of objects required
    credentials object
    • accessLevels array of string enums required
      read_write
    • wrappedKey string required

      at least 1 characters

    • iv string required

      at least 1 characters

    • tag string required

      at least 1 characters

    • masterKeyVersion number required
    • credentials string required

      at least 1 characters

    • expirationDate string date-time
  • name string required
    A unique name for the account. This is used to identify the account in BitGo and must be unique within your enterprise.

    at least 1 characters

  • description string required
    An optional description for the account. This can be any string and is not required to be unique.

    at least 1 characters

  • whitelistingEnabled boolean
    Optional flag to indicate if whitelisting is enabled on the venue. This means withdrawals can only happen to previously whitelisted addresses.
  • parentAccount string
    An optional parent account id to link this account to. This is used for sub-accounts under a main account. The parent account must already exist in BitGo.

Responses

201
Created

Response Body

object

  • id string required
  • venueId string required

    at least 1 characters

  • credentials array of objects required
    credentials object
    • id string required
    • accessLevels array of string enums required
      readwriteread_write
    • expirationDate string

      at least 1 characters

  • status string enum required
    activeinactivedeletedpending_credentials
  • name string required

    at least 1 characters

  • description string required

    at least 1 characters

  • whitelistingEnabled boolean required
  • parentAccount string
  • users array of objects
    users object
    • permissions array of string enums required
      link.account.adminlink.account.transferlink.account.view
    • userId string required

      at least 1 characters

  • createdDate string date-time required
  • modifiedDate string date-time required
400
Bad Request
No response body
401
Unauthorized

Response Body

object

  • errorName string required
  • error string required
403
Forbidden

Response Body

object

  • errorName string required
  • error string required
409
Conflict

Response Body

object

  • errorName string required
  • error string required
500
Internal Server Error

Response Body

object

  • errorName string required
  • error string required