Perform a Three-Way Account Link

Further Account Linking Guidance

---

Once a merchant has accepted the OAuth scope, an access & refresh token is generated for the merchant. If the MCA refresh token has been stored, an API request can be made using accounts.link with an AccountsLinkRequest object. The action should be "request".

Conversely, an API request then can be made immediately after using the subaccount's token, with an AccountsLinkRequest object. The action type should be "approved". This enables a streamlined account linking workflow for your merchants joining your platform.

Tip: In the accounts.link API Request. There might be a case where you'd need to do a 3-way merchant link where a subaccount needs to be linked to another external account that is managing its inventory.

Perform a Three-Way Account Link

---

Assume you have the following example accounts:

Account	Purpose
111111111	MCA Account
2222222	Other Subaccount
3333333	New Onboarding Account

The account.link resource for LINK REQUEST would have the following for its parameters:

Parameter	Value
merchantID	111111111
accountID	2222222

And the AccountLinkRequest body would have the following properties:

Property	Value
linkType	eCommercePlatform
linkedAccountId	3333333
action	request

Important: This request would be made using an API client that has the MCA Account OAuth Token.

Conversely, the account.link resource for LINK APPROVE would have the following for its parameters:

Parameter	Value
merchantID	3333333
accountID	3333333

And the AccountLinkRequest body would have the following properties:

Property	Value
linkType	eCommercePlatform
linkedAccountId	2222222
action	approve
eCommercePlatformLinkInfo.externalAccountId	your external identifier for the customer
services	shoppingAdsProductManagement

Important: This request would be made using an API client that has the Subaccount OAuth Token.