Authorize your Application to Access Vendor Groups

Before your vendor application can access data through the Selling Partner API (SP-API), you must authorize your application. For vendor applications, the authorization process has some unique aspects related to vendor groups.

This topic explains how vendor group authorization works and how to authorize your application for multiple vendor groups.

About vendor groups and authorization

When you authorize a vendor application, you grant it permission to access data for:

• The vendor group associated with your Vendor Central sign-in credentials.
• All vendor codes within that vendor group.

A vendor group is the account you log in to, which can include multiple vendor codes. Vendor codes allow you to:

• List products in specific categories.
• Include different business agreements.
• Manage different brands.

Your developer profile is associated with a specific vendor group. In Vendor Central, you can view multiple vendor groups on the Manage Authorizations page.

Authorize an application to access multiple vendor groups

You can use the Vendor Central self-authorization page to authorize multiple vendor groups for a single application using one developer account. You don't need to apply for a developer account for each vendor group. This authorization approach reduces the need to create identical applications for each individual vendor group.

You can authorize a maximum of 10 vendor groups per application. When you reach this limit, you must revoke a self-authorization or contact Vendor Central Support to request a quota increase. To learn how to revoke authorizations from your application, refer to Revoke Self-Authorizations from your Application.

To authorize multiple vendor groups:

1. Self-authorize your vendor application in Vendor Central.
   If your vendor group or account is not in this list, sign in to the missing group and navigate to the authorization page for your application. The vendor group is now listed on this page.

2. Choose Authorize app for each vendor group that you want to authorize. Use the generated refresh token to get access tokens, which you can use to call the SP-API.

   ❗️

   Important

   Use the refresh token that is assigned to the vendor group that you want to access in your API call. If you try to retrieve or submit data related to a different vendor group, the call fails due to an authorization error. For more information, refer to Connect to the Selling Partner API.

Check the vendor codes in your vendor group

1. Go to Vendor Central for your marketplace.

2. Sign in using the credentials for the Vendor Central account that is associated with the vendor group you want your application to access.

3. In the Settings menu, choose Contacts. Verify that the vendor codes that you want your application to access are listed. If the vendor codes aren't listed, you don't have permissions to access the corresponding vendor group. Request access from your vendor organization administrator and try again.