Skip to main content

Help with User Tokens

My OAuth token expired

First, verify that you are using the correct type of token:

  • REST API calls that only do searches (e.g., the Browse API) can use an Application access token.
  • REST API calls that get a user’s personal data must use a User access token.

User tokens typically expire within two hours. Therefore, if you’re using a tool like the eBay API Explorer, Postman, or SOAPui to test your requests and you’re pasting in a user token, please keep in mind that you’ll need to get a new user token every 2 hours or so.

To update a user token without signing into eBay every time, configure a refresh token, and then use it to get new user access tokens programmatically.

For details on managing OAuth tokens, see:

My Auth 'n' Auth token expired

To renew your user tokens without signing into your developer account, implement support to Get Tokens from your application.

To update your token manually from within your developer account:

  1. Go to the User Tokens page for your Production AppID, and follow the instructions to “Get a User Token Here”.
  2. Choose Production as the environment and Auth 'n' Auth as the token type.
  3. Click the blue button to sign into eBay’s Production site. You will be redirected to sign in to eBay.
  4. On the eBay sign-in page, enter the eBay username and password for the eBay member.
  5. On the next screen, consent to allow the application to access that member’s data.
  6. After you are redirected back to the User Tokens page on, you will see the token for that user.
    The token will not be stored in your developer account. You can copy the token and save it locally. The token will expire after 18 months.
I need to change my application or company name

To change the application name on your customized eBay sign-in form yourself, edit the Display Title for your RUname in Get a Token from eBay via Your Application.

You will need to file a Premium Support ticket to update the following fields in your developer account:

  • Application keyset name
  • Company name

Help with Specific eBay APIs or SDKs

I need to increase my API Call Limits

See the eBay API Call Limits page for the default call limits and maximum limits.

Periodically check your current API usage on the Reports tab for your App ID in your developer accout.

For higher limits, please review the requirements before completing our free app check.

I made no changes to my code; but now I am receiving errors

Please check our API Status page to make sure there are no known issues with the API:

If you need further assistance to isolate the root cause in your case, please use these support channels:

I have a technical use case that isn't described here
For all other technical questions, please use these support channels:

To expedite your request, provide your JSON or XML eBay request/response samples, along with steps to reproduce the issue. If you use the forums, be careful to not expose the token or your application credentials when you include the samples.

Help with eBay Buying and Selling

I heard about "STP" and I want to enable it on my eBay account

Thank you for your inquiry in to eBay’s discount pricing program, specifically for access to strike-through pricing (STP). Unfortunately, we are no longer handling individual requests to enable STP for sellers.

The following resources are available for enabling discount pricing:

Seller Hub Marketing tools – Seller Hub provides easy access to marketing tools for eBay Stores subscribers, including Promotions Manager, which lets you create special offers that encourage buyers to shop more of your items and spend more on each order.

Promotions manager: Sale event + markdown – the Sale event + markdown promotion type provides a way to put your store items on sale, creating promotions that are seasonal, for specific holidays, for specific categories, or just to clear out inventory.

Marketing API – the Marketing API lets sellers and merchants manage the life cycle of promoted listings and item promotions and generate reports. The methods in the promotion-related resources give you programmatic access to the capabilities of Promotions Manager so you can scale and customize the experience of creating and managing item promotions.

I'm a buyer or seller, and I need to contact eBay Customer Service

For most eBay sites, you can use "https://www.ebay.<extension>/help/home", which will redirect you to the Customer Service for your region. For example:


An error says I violated an eBay policy

This typically occurs due to a violation of one or more seller performance standards or policies:

If you’re using one of the AddItem family of calls, there might be additional details in the Message tag in the response.

If you receive an "International Selling Agreement" error, see these resources:

If you are not sure how to tell whether you’ve opted in or out, please contact eBay Customer Service to check your seller account settings. See "I'm a buyer or seller, and I need to contact eBay Customer Service" above.

Help with Other eBay Topics

I have a cool idea for eBay’s Business

Members of the eBay Developers Program are welcome to create their own products and experiences, leveraging our publicly available APIs, in accordance with our API License Agreement and policies.

eBay API License Agreement

Selling on eBay

Buying on eBay

If you are looking to share other ideas, proposals, or suggestions with eBay regarding our business, products, and capabilities, please read eBay's Unsolicited Idea Submissions Policy

I found an issue while using eBay Mobile

You are welcome to provide feedback directly to the eBay Mobile team via either of these eBay community discussion boards: