Accounts & Login

Adding and managing your Apple Developer account is the first step to using most features of Happy Listing (except Files & Submit, which does not require login).

Three Login Methods

When adding an account, first choose between two input methods: Account & Password and API Key. Account & Password supports both paid and free Apple IDs:

Login Method	Description	Applicable Scenarios
Web Login (Web / idmsa)	Log in to the developer portal using your Apple ID and password. Supports two-factor authentication. Most feature-complete.	Paid accounts enrolled in the Apple Developer Program that need all features including Certificates, Bundle IDs, Provisioning Profiles, and Devices
App Login (App / xcode)	Log in with a free account without Xcode, using the App protocol.	Free Apple IDs not enrolled in a paid Apple Developer Program
API Key (API Key / asc)	Uses an App Store Connect API key for stateless JWT authentication. Requires no password, does not trigger two-factor authentication, and is valid for a long period.	Password-free, no-2FA long-term access; suitable for team collaboration or automation scenarios

An API Key can be manually entered when adding an account by filling in the Issuer ID / Key ID / .p8 private key (or by directly importing a .json key file). Alternatively, after logging in with an account password, you can generate one on the Account Overview page. The .p8 private key is stored only locally in the browser, never uploaded to a server, and is used only to sign short-lived tokens locally.

Free accounts that have not paid the $99 developer membership should use App Login. Web Login and API Key usually require the account to be enrolled in the paid Apple Developer Program.

Adding and Managing Accounts

Click Add Account and choose the input method (Account & Password / API Key).
Fill in the corresponding credentials and click Log In. If the account has two-factor authentication enabled, a verification dialog will appear. Select Push to Trusted Device or enter the SMS verification code to complete verification.
After successful login, the account is saved in the Saved Accounts list. You can then click Enter for the account directly without re-entering your password.
To switch between multiple accounts, use the Switch Account entry at the top, or choose another account from the list.
To remove a no-longer-needed account, click Remove Account. This deletes the credentials saved in the browser as well as the locally stored login session and key files. If local file deletion fails, you can also choose Remove Browser Records Only to keep local files.

For actions that need identity re-verification (for example, displaying or using sensitive credentials), the system may show a Verify Identity prompt at any time, asking you to re-enter your Apple ID password or provide the .p8 private key. The server only validates against Apple; this does not trigger a new login or verification code.

Team and Membership Status

A single Apple ID can belong to multiple developer teams. After login, select the team you need to work on from the Account Overview. Features such as Certificates, Bundle IDs, Provisioning Profiles, Devices, and Apps all depend on the currently active team. If the selected team has no paid Apple Developer Program membership, the page will show “This Apple ID has no Apple Developer Program team” and guide you to register on Apple’s website.

Apple Developer Agreement

Apple updates the Developer Agreement periodically; you need to agree before continuing to use features such as Certificates, Bundle IDs, Provisioning Profiles, and others. When the system detects pending agreements, it will show Agreements Pending. Click View & Agree to process them individually. Some agreements (involving identity verification, country/region updates, tax, or banking information) cannot be agreed to inside this app; go to developer.apple.com or App Store Connect to complete them.

You can also enable Auto-Agree Apple Agreements in Settings. Once enabled, any detected agreement updates will be agreed to automatically without a confirmation popup (paid app agreements are signed automatically as well). Agreements that still require additional information are excluded. This is equivalent to signing Apple contracts on your behalf. Enable this feature cautiously.

Other Settings (Desktop)

Network Proxy: Configure or clear the HTTP(S) outbound proxy. Leave it blank to use the system network settings. After changing it, click Test Connection to display your current outbound IP.
Stop Services: Stop local services running on this machine. Restart the app to continue using them.
Language Switch: Toggle between Simplified Chinese and English interfaces.