Authorize Vendor Groups for Application Access

📘

Note

This information applies to vendor applications only.

When you authorize your Selling Partner API application to access your data, you are granting access to the vendor group that is associated with the sign-in credentials for your Vendor Central account. By extension, you are granting access to all vendor codes present in the vendor group. Therefore, it's important to use the right Vendor Central credentials and vendor group for your Selling Partner API integration.

The vendor group is the account you log in to, and depending on business agreements, operation models, and other factors, can include one or more vendor codes. Each vendor code allows you to list products in a specific category, or includes the necessary business agreements, such as one vendor code for a particular brand.

Vendors can generate multiple refresh tokens respective to each vendor group or create a single vendor group that contains all of their vendor codes.

The option to utilize multiple vendor groups from the vendor group your profile is associated with, gives you the ability to use an application with the same vendor code in different vendor groups. With this option you don't have to submit multiple vendor developer applications for each group.

Use multiple vendor groups to authorize an application

This section explains how to use the self-authorization page in Vendor Central to authorize multiple vendor groups to a single application, using one developer account. This authorization approach reduces the need to create identical applications for each individual vendor group. Use the following instructions to set up authorization grants and generate a refresh token between your applications and any vendor group or the Vendor Central account to which you have administrative access.

1. Self-authorize your vendor application in Vendor Central.

   ![The Manage Authorizations page, which shows the Authorize App button for each app.](https://m.media-amazon.com/images/G/01/spapi/dev_guide/multiple_vendor_groups/authorize-for-account.png)
   

   For ease of reference, you can store your existing Login with Amazon (LWA) refresh token credentials securely in an encrypted location for each Vendor Central account that you authorized your application to access. You can use these refresh tokens to get access tokens for calling Selling Partner APIs. When you call a Selling Partner API to access a selling partner account, include the access token that corresponds to that account. For more information, refer to Connecting to the Selling Partner API.

2. Your developer profile is associated with a specific vendor group. If you are an admin of multiple vendor groups, your other vendor groups should show up on the Manage Authorizations page in the associated vendor group. If you can't find your desired vendor groups/accounts, sign in to the missing group. If you find your groups/accounts, skip to step 3.

3. Choose Authorize app for each vendor group you want to authorize. You can use the refresh token to get access tokens for calling Selling Partner APIs for the second vendor group as well. For more information, refer to Connecting to the Selling Partner API.

There is a maximum limit of 10 self-authorizations for generating refresh tokens at the application level. When your application has reached the limit of 10 self-authorizations, you must either revoke an existing self-authorization or contact [Vendor Central Support](https://vendorcentral.amazon.com/hz/vendor/members/contact) to increase your quota. If you want to remove authorizations from your application, refer to [Application Authorization Limits](https://developer-docs.amazon.com/sp-api/docs/application-authorization-limits)

[block:image]
{
  "images": [
    {
      "image": [
        "https://m.media-amazon.com/images/G/01/spapi/dev_guide/multiple_vendor_groups/revoke-auths.png",
        "A screenshot showing the Revoke button."
      ],
      "align": "center",
      "caption": "Revoke application authorizations."
    }
  ]
}
[/block]

Use a single vendor group to authorize an application

If you use a single vendor group to manage all of your vendor codes, you can authorize an application to access the data in that vendor group. To do this, register as a developer using the credentials for the Vendor Central account associated with the vendor group.

To be sure that your vendor group contains all of the vendor codes that you want your application to access, check the vendor codes in your vendor group. You can add or remove vendor codes from your vendor group at any time.

Check the vendor codes in your vendor group

1. Go to Vendor Central for your marketplace. Refer to Vendor Central URLs for a list of URLs by marketplace.

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

3. On the Settings menu, choose Contacts.

4. Review the Contacts page to determine if the vendor codes that you want your application to access are present.

Add or remove vendor codes from your vendor group

1. Go to Vendor Central for your marketplace. Refer to Vendor Central URLs for a list of URLs by marketplace.

2. Sign in using the credentials for the Vendor Central account with the vendor group for which you want to add or remove vendor codes.

3. Choose the Support link at the top of the page.

4. On the Support page, choose Contact Us.

5. On the Contact Amazon support page, choose Settings and Account Management, then choose Account Settings.

6. In the Settings and Account Management box, at the bottom, choose Still need help?.

7. Follow the instructions to contact Amazon support.