Selecting iTunes Provider for Notarization

When uploading your package for notarization, altool could fail with the following error message:

Error: Your Apple ID account is attached to other iTunes providers. You will need to specify which provider you intend to submit content to by using the -itc_provider command. Please contact us if you have questions or need help. (1627)

This usually happpens if you use your Apple ID for uploading something else than software. Examples are books (for Apple Books) and music (for Apple Music and/or iTunes Store). In this case, you would need to specify which provider name are you using.

These provider names are unique, dependent on the account and which store that it is for. That is, Apple will create one string for the entity that uploads stuff to the App Store and another string for the Apple Books store. If you sign up to the stores as a natural person (instead of an organization), these strings woould be derived from your legal name and be unique to your account.

Since you’re using altool, you’ll want to use the provider name associated with the App Store. Even though your intention of notarization is for Developer ID distribution outside the App Store.

Confused? Read on and you’ll be notarizing your binaries in no time. I’ll show you how to get all provider names associated with your account and select which one to use to continue with notarization.


Be sure to have these on-hand, which you probably have since you’re already using altool.

  • Xcode – I’ve tested this guide on version 11.0 but any newer version should work.
  • Your Apple ID user and password.
  • An app-specific password for your Apple ID.
  • A web browser and working Internet connection.

Listing Provider Names

You can get the list of provider names attached to your account by running iTMSTransporter from the command-line. This is a Java program embedded in Xcode which it uses internally for uploading to the App Store. Apparently this program is also used for media labels to upload music and videos to Apple.

/Applications/ -m provider -u "" -p "app-specific-password"

Be sure to replace your Apple ID and your app-specific password as appropriate.

The command  would return a listing like the following:

  - Long Name -              - Short Name -
1  Your Name                  YourName
2  Your Name|123456789        YourName123456789

What you want is to pick out the short name listed and use it as a parameter to altool for specifying the provider name.

Picking the Right Provider Name.

Follow these steps to select the right provider name

  1. Login to App Store Connect.
  2. In the top-left drop down select “Users and Access”.
  3. In the list of all users, select “Account Holder”
    App store connect account holder 2x
  4. Select the account holder.
  5. The provider long name would be shown in the middle section in a heading font.
    App store connect provider long name 2x

Notarizing The App

Finally add the provider name as a parameter to altool. Despite what the error message said, the parameter to specify the provider name is --asc-provider, not -itc_provider. Probably because altool is a wrapper for the Java-based iTMSTransporter and the two development groups haven’t gotten around to synchronize the error message to the parameter.

Run a command like the following to notarize your bundle. Notice the new argument --asc-provider which has the the provider short name as its parameter.

xcrun altool --notarize-app --primary-bundle-id com.example.YourApp -u "" -p "app-specific-password" --asc-provider "ProviderName123456789" --file 

Remember to replace the parameters like bundle identifier and Apple ID credentials as appropriate. Also note that altool takes a single file as an argument, hence you’ll need to zip your bundle or enclose it in a disk image.

Avoid App Review rules by distributing outside the Mac App Store!

Get my FREE cheat sheets to help you distribute real macOS applications directly to power users.

* indicates required

When you subscribe you’ll also get programming tips, business advices, and career rants from the trenches about twice a month. I respect your e-mail privacy.

Avoid Delays and Rejections when Submitting Your App to The Store!

Follow my FREE cheat sheets to design, develop, or even amend your app to deserve its virtual shelf space in the App Store.

* indicates required

When you subscribe you’ll also get programming tips, business advices, and career rants from the trenches about twice a month. I respect your e-mail privacy.

0 thoughts on “Selecting iTunes Provider for Notarization

Leave a Reply