Add a User to the Child Business Manager, Optional or Debugging

By default, only the system user is created and added to the child Business Manager. You can add an advertiser to the child Business Manager if there is a business case to add it. Adding a developer to a child Business Manager is quite useful for debugging purposes.

The API calls below shows how you can add users to the child Business Manager and log in to the Business Manager UI to access the newly created child Business Manager.

On March 16, 2020, we removed the ability to add Admins to child Business Managers in the 2-tier Business Manager. Admins of a parent Business Manager can still add people as Employees to child Business Managers in order to have insight into those accounts.

Fetch the Access Token of the Child Business Manager's System User

This creates a child Admin system user and fetches the corresponding token.

curl \
  -F 'id=<CHILD_BM_ID>' \
  -F 'app_id=<APP_ID>' \
  -F 'scope=ads_management,business_management' \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'appsecret_proof=<APP_SECRET>' \
  https://graph.facebook.com/<API_VERSION>/<CHILD_BM_ID>/access_token

Add a User to the Child Business Manager (Optional)

You can also add a user with the role of EMPLOYEE to the child business manager if they are an EMPLOYEE on the parent business manager. We don't recommend doing this often unless for debugging purposes.

curl \
  -F 'email=<EMAIL_ADDRESS_OF_USER>' \
  -F 'role=EMPLOYEE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'appsecret_proof=<APP_SECRET>' \
  https://graph.facebook.com/<API_VERSION>/<CHILD_BM_ID>/business_users

Join the Business Manager (Optional)

If you don't want to check your email to accept the invitation to join the Business Manager, you can query for it via the API and directly go to it: 1. Parse the invite_link field from the response below. 2. Go to a browser to the URL returned in this API call.

You will be prompted to log in using your Facebook account. Thereafter, which you'll get access to the child Business Manager.

curl -X DELETE \
  -d 'client_id=<CHILD_BM_ID>' \
  -d 'access_token=<ACCESS_TOKEN>' \
  -d 'appsecret_proof=<APP_SECRET>' \
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_ID>/owned_businesses