Set Up Child Enterprises

Overview

Within your parent organization, you must create a child enterprise and a BitGo user account for each of your users. To create the user accounts in BitGo, you must submit your users' personal information for Know Your Customer (KYC) verification. In addition to onboarding your users, you must also onboard the service user from your organization. However, the service user doesn't require KYC verification when you add them to the child enterprises, because they already completed KYC verification when you initially added them to your enterprise.

Note: You must add the same service user to every child enterprise you create.

Prerequisites

• Get Started
• Set Up Organization

Set Up Child Enterprise

In call, you create the child enterprise and the user account, as well as add the service user to the child enterprise.

Endpoint: Create an Enterprise for an Organization

Copy code block
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
export ORGANIZATION_ID="<YOUR_ORGANIZATION_ID>"
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
export EMAIL="<YOUR_USER'S_EMAIL>"
export IDEMPOTENCY_KEY="<UNIQUE_IDENTIFIER_PER_REQUEST>"
export ADDITIONAL_ADMIN_1="<OSERVICE_USER_ID>"
export ADDITIONAL_ADMIN_2="<ORGANIZATION_ADMIN_USER_ID>"

curl -X POST \
  "https://app.bitgo-test.com/api/v2/organization/$ORGANIZATION_ID/enterprise" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
    "email": "'"$EMAIL"'",
    "idempotencyKey": "'"$IDEMPOTENCY_KEY"'",
    "additionalAdmins": [
      "'"$ADDITIONAL_ADMIN_1"'", # this is your service user
      "'"$ADDITIONAL_ADMIN_2"'" # this is your organization admin
      ]
}'

Step Result

All of the following occurs:

• Create a new child enterprise within your parent organization.
• Create a new user for the child enterprise (this is your end user).
• Assign the service user to the child enterprise.
• Assign organization admins to the child enterprise.

Copy code block
1
2
3
4
{
  "enterpriseId": "59cd72485007a239fb00282ed480da1f",
  "userId": "59cd72485007a239fb00282ed480da1f"
}

Next Steps

Complete KYC Verification for individual users or Complete KYB Verification for business users.

See Also

• API Reference: Create an Enterprise for an Organization