Accept a payment dispute and allow eBay to refund the buyer. Use this when you agree with the buyer claim.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Add evidence to support your case in a payment dispute. Provide evidence files and supporting information.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Cancel multiple packages in one request

Confirm multiple packages in one request

Create multiple ad group-level negative keywords.

Create multiple ads using Inventory API references (SKU/inventory item group key). CPS campaigns only.

Create multiple ads using listing IDs. Maximum 500 listings per call. Supports both CPS and CPC campaigns.

Bulk create keywords at the campaign level.

Create multiple campaign-level negative keywords.

Create multiple keywords in a campaign. Maximum recommended per call varies by eBay.

Bulk create multiple offers

Bulk create or replace multiple inventory items

Bulk create or replace sales tax tables

Delete multiple ad group-level negative keywords.

Delete multiple ads by inventory reference. CPS campaigns only.

Delete multiple ads by listing ID. CPS campaigns only.

Delete multiple campaign-level negative keywords.

Delete multiple keywords from a campaign.

Delete multiple packages in one request

Bulk get multiple inventory items

Bulk migrate listings to the inventory model

Bulk publish multiple offers

Update multiple ad group-level negative keywords.

Update bid percentages for multiple ads by inventory reference. CPS campaigns only.

Update bid percentages for multiple ads by listing ID. CPS campaigns only.

Update status for multiple ads. CPC priority strategy campaigns only.

Update status for multiple ads by listing ID. CPC priority strategy campaigns only.

Bulk update keywords at the campaign level.

Update multiple campaign-level negative keywords.

Bulk update multiple conversations (read status, flagged, etc.)

Update bids for multiple keywords.

Bulk update price and quantity for multiple offers

Cancel a bundle by ID

Cancel a package by ID

Clear all stored OAuth tokens (both user tokens and client credentials). This will require re-authentication for subsequent API calls.

Clone an ad within a campaign.

Clone an ad group within a campaign.

Clone an existing campaign with new settings. Useful for creating campaigns with modified budget or duration.

Clone a package to create a duplicate

Confirm a package for shipping

Contest a payment dispute by providing evidence. Use this when you disagree with the buyer claim and want to provide proof.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Convert a date string or number to Unix timestamp (milliseconds). Supports ISO 8601 dates, Unix timestamps (seconds or milliseconds), and relative time (e.g., "in 2 hours", "in 7200 seconds"). Useful when setting token expiry times from user input.

Create a single ad in a campaign. Supports both CPS and CPC campaigns.

Create an address preference for international shipping

Create an ad group for manual targeting in a CPC campaign. Required for CPC campaigns with manual targeting.

Create an ad group-level negative keyword. Prevents ads in this ad group from showing for this keyword.

Create ads using Inventory API references. CPS campaigns only.

Create a bundle of packages for international shipping

Create a new marketing campaign. Supports both CPS (Cost Per Sale) and CPC (Cost Per Click) campaigns.

Create a campaign-level negative keyword. Prevents ads from showing for this keyword across entire campaign.

Create a complaint for international shipping issues

Create a consign preference for international shipping

Create a new custom policy

Create a new email marketing campaign.

Create a new fulfillment policy.

Required OAuth Scope: sell.account Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.account

Create or replace an inventory item.

Required OAuth Scope: sell.inventory Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory

Create an item price markdown promotion (sale pricing).

Create a new item promotion (order discount, volume pricing, etc.).

Create a keyword for manual targeting in a CPC campaign ad group.

Create a new fixed-price listing.

Uses the Trading API (AddFixedPriceItem). Requires complete item details.

Required: User OAuth token.

Create a notification destination

Create a notification subscription

Create a filter for a notification subscription

Create a new offer for an inventory item

Create or replace an inventory item group

Create or replace an inventory location

Create or replace product compatibility for an inventory item

Create or replace sales tax table for a jurisdiction

Create or replace SKU location mapping for a listing. Maps a SKU to multiple fulfillment center locations.

Required OAuth Scope: sell.inventory Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory

Create a package for international shipping

Create a new payment policy

Create an asynchronous report generation task. Reports are generated in the background.

Create a new return policy

Create a shipping fulfillment for an order.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Create a shipping quote for international shipping

Create a new signing keypair for API digital signatures. Supports ED25519 (recommended) or RSA ciphers. IMPORTANT: Save the private key immediately as eBay does not store it.

Create targeting configuration for a campaign.

Create a VERO report to report intellectual property infringement. This endpoint is part of the Verified Rights Owner (VeRO) Program and allows rights owners to report listings that infringe on their intellectual property.

Delete a specific ad from a campaign.

Delete an ad group-level negative keyword.

Delete ads by inventory reference for a CPS campaign.

Permanently delete a marketing campaign. This action cannot be undone.

Delete a campaign-level negative keyword.

Delete a custom policy

Delete an email campaign.

Delete a fulfillment policy

Delete an inventory item by SKU.

Required OAuth Scope: sell.inventory Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory

Delete an inventory item group

Delete an inventory location

Delete an item price markdown promotion.

Delete an item promotion.

Delete a specific keyword from a campaign.

Delete a notification destination

Delete a notification subscription

Delete a subscription filter

Delete an offer

Delete a package by ID

Delete a payment policy

Delete product compatibility for an inventory item

Delete a report task. Only completed or failed tasks can be deleted.

Delete a return policy

Delete sales tax table for a jurisdiction

Delete SKU location mapping for a listing. Removes all fulfillment center location mappings for a SKU.

Required OAuth Scope: sell.inventory Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory

Disable an inventory location

Disable a notification subscription

Display all eBay API credentials and current token information. Shows client ID, client secret (masked), environment (production/sandbox), redirect URI, and current token status including access token (masked), refresh token (masked), app token (masked), and their expiry times. Useful for debugging authentication issues and verifying configuration.

Enable an inventory location

Enable a notification subscription

Permanently end a marketing campaign. Cannot be restarted after ending.

End/remove an active fixed-price listing.

Uses the Trading API (EndFixedPriceItem).

Required: User OAuth token.

Exchange an OAuth authorization code for access and refresh tokens. This completes the OAuth 2.0 Authorization Code grant flow. After the user authorizes the application using the URL from ebay_get_oauth_url, eBay redirects back with an authorization code in the URL. Use this tool to exchange that code for tokens that can be used to make API calls. The tokens will be automatically stored and used for subsequent API requests.

IMPORTANT NOTES:

• Authorization codes expire in ~5 minutes - if you get "invalid grant" error, get a fresh code

• Codes can be URL-encoded (e.g., v%5E1.1%23...) - this tool automatically decodes them

• Extract the code parameter from the redirect URL (your RuName Accept URL): https://your-redirect-uri?code=YOUR_CODE&expires_in=299

• Tokens are saved to .env file and will auto-refresh every 2 hours

• Refresh tokens last 18 months before requiring re-authorization

COMMON ERRORS:

• "invalid or was issued to another client": Code expired, get fresh code

• "Insufficient permissions": Re-run OAuth flow with additional scopes in ebay_get_oauth_url

For complete OAuth guide with scopes, troubleshooting, and examples, see: docs/auth/OAUTH_QUICK_REFERENCE.md

Download evidence file content from a payment dispute.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Find a campaign by listing ID or inventory reference.

Find listing recommendations for items. Returns suggestions to improve listing performance.

Find all seller standards profiles

Get all active fixed-price listings with SKU, quantity, price, and watch count.

Uses the Trading API (GetMyeBaySelling). Returns listings created via any method (UI, Trading API, or REST API).

Required: User OAuth token.

Get actual costs for shipped packages

Get details of a specific ad in a campaign.

Get address preferences for international shipping

Get details of a specific ad group.

Get details of a specific ad group-level negative keyword.

Get all negative keywords for an ad group.

Get all ad groups for a campaign.

Download a completed ad report by report ID.

Get metadata for all available report types. Returns dimensions, metrics, and filters.

Get metadata for a specific report type.

Get all ads for a campaign with optional filters.

Get ads by inventory reference (SKU or inventory item group key). CPS campaigns only.

Get ads by listing ID. Returns all ads for the specified listing.

Check the seller eligibility status for eBay advertising programs. This allows developers to determine if a seller is eligible for various advertising programs on eBay.

Required OAuth Scope: sell.account.readonly or sell.account

Get available shipping agents for international shipping

Get the latest eBay API status and incidents from the official RSS feed. Returns recent issues, fixes, and outages for eBay APIs (e.g. Trading API, Inventory API, Sandbox). Use when the user asks about API status, outages, or fixes.

Get automotive parts compatibility policies for a marketplace

Get transactions awaiting feedback from the seller

Get battery qualifications for international shipping

Get bundle details by ID

Get shipping label for a bundle

Get details of a specific marketing campaign by ID. Returns campaign configuration, status, and statistics.

Find a campaign by its name. Returns campaign details if a matching name is found.

Get details of a specific campaign-level negative keyword.

Get all campaign-level negative keywords.

Get all marketing campaigns for the seller. Returns campaigns with status, budget, and performance data.

Get category policies for a marketplace

Get category suggestions based on query

Get category tree by ID

Get classified ad policies for a marketplace

Get compatibilities by specification

Get compatibility property names

Get compatibility property values

Get consign preferences for international shipping

Get a specific conversation by ID

Get all buyer-seller conversations (paginated)

Get currencies for a marketplace

Get customer service metrics

Retrieve custom policies defined for the seller account

Get a specific custom policy by ID

Get the default category tree ID for a marketplace

Get available dropoff sites for international shipping

Get available audiences for email campaigns.

Get details of a specific email campaign.

Get all email marketing campaigns.

Get a preview of an email campaign.

Get performance report for email campaigns.

Get extended producer responsibility policies for a marketplace

Get feedback for a user by type

Get feedback rating summary for a user

Get feedback summary for the seller

Get fulfillment policies for the seller.

Required OAuth Scope: sell.account.readonly or sell.account Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.account.readonly

Get a specific fulfillment policy by ID

Get a fulfillment policy by name

Get handover sheet for packages

Get hazardous materials labels for a marketplace

Get a specific inventory item by SKU.

Required OAuth Scope: sell.inventory.readonly or sell.inventory Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory.readonly

Get an inventory item group (variation group)

Retrieve all inventory items for the seller.

Required OAuth Scope: sell.inventory.readonly or sell.inventory Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory.readonly

Get a specific inventory location

Get all inventory locations

Get item aspects for a specific category

Get item condition policies for a marketplace

Get details of a specific item price markdown promotion.

Get details of a specific item promotion.

Get details of a specific keyword.

Get all keywords for a campaign.

Get seller KYC (Know Your Customer) status

Get shipping labels for packages

Get full details for a single listing by item ID.

Uses the Trading API (GetItem). Returns all listing fields including description, specifics, shipping, and images.

Required: User OAuth token.

Get listing fees for offers before publishing

Get inventory locations for a specific listing (SKU location mapping).

Required OAuth Scope: sell.inventory.readonly or sell.inventory Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory.readonly

Get the listing set (items included) for a promotion.

Get listing structure policies for a marketplace

Get listing type policies for a marketplace

Get listing violations for the seller

Get summary of listing violations

Get a specific message by ID

Get motors listing policies for a marketplace

Get multiple compatibility property values

Get negotiated price policies for a marketplace

Get notification configuration

Get a specific notification destination by ID

Get all notification destinations (paginated)

Get a public key for verifying notification signatures

Get a specific notification subscription by ID

Get a specific subscription filter

Get all notification subscriptions (paginated)

Get a specific notification topic by ID

Get all available notification topics (paginated)

Generate the eBay OAuth authorization URL for user consent. The user should open this URL in a browser to grant permissions to the application. This supports the OAuth 2.0 Authorization Code grant flow. The redirect URI can be provided as a parameter or will be read from EBAY_REDIRECT_URI environment variable.

IMPORTANT: eBay has different OAuth scopes available for production vs sandbox environments:

• Sandbox includes additional Buy API scopes (e.g., buy.order.readonly, buy.guest.order, buy.shopping.cart) and extended Identity scopes

• Production includes sell.edelivery, commerce.message (explicit), and commerce.shipping scopes not available in sandbox

• If you provide custom scopes, they will be validated against the current environment (set via EBAY_ENVIRONMENT). Any scopes not valid for the environment will generate warnings.

OAUTH FLOW INSTRUCTIONS:

1. Generate OAuth URL with this tool (optionally specify scopes)

2. User opens URL in browser, authorizes, and gets redirected with a code parameter

3. Use ebay_exchange_authorization_code tool with the code (URL-encoded format accepted)

4. Tokens are automatically stored and will auto-refresh every 2 hours

COMMON SCOPES:

• Basic (always included): https://api.ebay.com/oauth/api_scope

• Inventory: https://api.ebay.com/oauth/api_scope/sell.inventory

• Inventory (readonly): https://api.ebay.com/oauth/api_scope/sell.inventory.readonly

• Account: https://api.ebay.com/oauth/api_scope/sell.account

• Fulfillment: https://api.ebay.com/oauth/api_scope/sell.fulfillment

TROUBLESHOOTING:

• Authorization codes expire in ~5 minutes - get fresh code if "invalid grant" error

• "Insufficient permissions" errors mean you need to re-authorize with additional scopes

• OAuth URL format: Use + to separate scopes (e.g., scope=scope1+scope2), not %2B

• Refresh tokens last 18 months and are saved to .env file for persistence

Get a specific offer by ID

Get all offers for the seller

Get offers to buyers (Best Offers) for the seller

Get seller programs the account is opted into

Get details of a specific order.

Required OAuth Scope: sell.fulfillment.readonly or sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly

Retrieve orders for the seller.

Required OAuth Scope: sell.fulfillment.readonly or sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly

Get package details by ID

Get package details by order line item ID

Get detailed information about a specific payment dispute.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Get activity history for a payment dispute, including all actions taken by buyer, seller, and eBay.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Get summaries of all payment disputes. Use filters to narrow results by dispute status, buyer username, or order ID.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Get payment policies for the seller

Get a specific payment policy by ID

Get a payment policy by name

Get payments program status for a marketplace. Note: This method is deprecated as all seller accounts globally have been enabled for the new eBay payment and checkout flow.

Required OAuth Scope: sell.account.readonly or sell.account

Get payments program onboarding information. Note: This method is deprecated as all seller accounts globally have been enabled for the new eBay payment and checkout flow.

Required OAuth Scope: sell.account.readonly or sell.account

Get payments program status

Get seller's current set of privileges, including whether or not the seller's eBay registration has been completed, as well as the details of their site-wide sellingLimit (the maximum dollar value and quantity of items a seller can sell per day).

Required OAuth Scope: sell.account.readonly or sell.account

Get product compatibilities

Get product compatibility information for an inventory item

Get product safety labels for a marketplace

Get promotion performance report with sales and revenue data.

Get all item promotions with optional filters. Returns order discounts, shipping discounts, etc.

Get summary report of promotion performance across all promotions.

Get application rate limits for eBay APIs. Returns call quota, remaining calls, and time until reset for each API resource.

Get seller rate tables

Get regulatory policies for a marketplace

Download a completed report by report ID.

Get status and details of a specific report task.

Get all report tasks with optional filters.

Get return policies for the seller

Get a specific return policy by ID

Get a return policy by name

Get marketplace return policy requirements and guidelines. Returns eBay policies that define whether return policies are required for categories and the guidelines for creating domestic and international return policies.

Get sales tax table for a jurisdiction

Get all sales tax tables for a country

Get sales tax jurisdictions for a country

Get a specific seller standards profile

Get shipping cost type policies for a marketplace

Get a specific shipping fulfillment by ID.

Required OAuth Scope: sell.fulfillment.readonly or sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly

Get all shipping fulfillments for an order.

Required OAuth Scope: sell.fulfillment.readonly or sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly

Get shipping policies for a marketplace

Get a shipping quote by ID

Get available shipping services for international shipping

Get a specific signing key by ID. Returns public key and metadata (private key is not stored by eBay).

Get all signing keys for the application. Returns public keys and metadata (private keys are not stored by eBay).

Get site visibility policies for a marketplace

Get seller subscription information

Get targeting configuration for a campaign.

Check the current OAuth token status. Returns information about whether user tokens or client credentials are being used, and whether tokens are valid.

Get tracking information for packages

Get traffic report for listings

Get user identity information

Get user-specific rate limits for eBay APIs. Returns call quota per user for APIs that limit by user.

Get a specific VERO reason code by ID. Reason codes categorize the types of intellectual property violations.

Get all available VERO reason codes. These codes are used when creating VERO reports to specify the type of intellectual property violation.

Get a specific VERO report by ID

Get VERO report items (listings reported for intellectual property infringement). Supports filtering, pagination via limit and offset parameters.

Issue a full or partial refund for an eBay order. Use this to refund buyers for orders, including specifying the refund amount and reason.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Launch a campaign to start running ads. Campaign must be in PENDING status.

Leave feedback for a buyer

Opt-in to a payments program

Opt-in to a seller program

Opt-out of a seller program

Pause a running marketing campaign. Campaign can be resumed later.

Pause a running item promotion. Can be resumed later.

Pause a running promotion. Can be resumed later.

Publish an offer to create a listing

Publish an offer for an inventory item group (variation listing).

Required OAuth Scope: sell.inventory Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory

Manually refresh the user access token using the stored refresh token. This is useful when you want to proactively refresh an access token before it expires, or when recovering from authentication errors. Requires that user tokens are already set (either via EBAY_USER_REFRESH_TOKEN in .env or via ebay_set_user_tokens_with_expiry). Returns the new access token and expiry time.

Register a third party financial application with eBay (Open Banking / PSD2). Requires valid eIDAS certificate via MTLS.

Relist an ended fixed-price listing, optionally with modifications.

Uses the Trading API (RelistFixedPriceItem).

Required: User OAuth token.

Reply to a buyer message in an existing conversation thread

Respond to feedback received from a buyer

Resume a paused marketing campaign. Campaign will start running again.

Resume a paused item promotion.

Resume a paused promotion.

Revise an existing fixed-price listing. Update quantity, price, title, description, or any other field.

Uses the Trading API (ReviseFixedPriceItem). Only send the fields you want to change.

Examples:

• Update quantity: { "Quantity": 10 }

• Update price: { "StartPrice": 14.99 }

• Update title: { "Title": "New Title" }

• Multiple fields: { "Quantity": 10, "StartPrice": 14.99 }

Required: User OAuth token.

Search for buyer-seller messages

Send a direct message to a buyer regarding a specific transaction or inquiry. Use this to communicate about orders, answer questions, resolve issues, or provide updates.

Send offer to interested buyers

Create a quick campaign with simplified setup. Ideal for getting started fast.

Set the user access token and refresh token for authenticated API requests. These tokens should be obtained through the OAuth authorization code flow. Tokens will be persisted to disk and automatically refreshed when needed. User tokens provide higher rate limits (10,000-50,000 requests/day) compared to client credentials (1,000 requests/day).

Set user access and refresh tokens with custom expiry times. This is an enhanced version of ebay_set_user_tokens that accepts expiry times and can automatically refresh the access token if it's expired but the refresh token is valid. Useful when user provides tokens that may already be partially expired.

Get bid suggestions for an ad group. Helps optimize bid amounts based on competition.

Get budget suggestions for a campaign based on expected performance.

Get item suggestions for a campaign. Returns items that could perform well.

Get keyword suggestions for an ad group. Returns relevant keywords based on listings.

Get maximum CPC bid suggestions for ads based on competition.

Suppress a listing violation

Test a notification subscription by sending a test message

Translate listing text

Update the bid percentage for a specific ad.

Update an ad group configuration.

Update default bids for an ad group.

Update keywords for an ad group.

Update an ad group-level negative keyword.

Update the ad rate strategy for a CPS campaign.

Update the bidding strategy for a CPC campaign.

Update the daily budget for a campaign.

Update campaign name or other identification details.

Update a campaign-level negative keyword.

Update a single conversation (read status, flagged, etc.)

Update an existing custom policy

Update an existing email campaign.

Update an existing fulfillment policy

Update an existing item price markdown promotion.

Update an existing item promotion.

Update a keyword configuration.

Update the bid for a specific keyword.

Update location details for an inventory location

Update notification configuration

Update a notification destination

Update a notification subscription

Update an existing offer

Update existing evidence in a payment dispute.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Update an existing payment policy

Update an existing return policy

Update targeting configuration for a campaign.

Upload a file as evidence for a payment dispute (e.g., shipping receipt, photos). Returns a file ID to use with add_evidence.

Required OAuth Scope: sell.fulfillment Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment

Validate token expiry times and get recommendations. Checks if access/refresh tokens are expired or expiring soon, and provides actionable recommendations (e.g., refresh access token, re-authorize user).

Withdraw a published offer

Withdraw an offer for an inventory item group (variation listing).

Required OAuth Scope: sell.inventory Minimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory

Fetch a specific eBay inventory item by SKU

Search for eBay inventory items