---
title: eBay API Integration on Truto
slug: ebay
category: E-Commerce
canonical: "https://truto.one/integrations/detail/ebay/"
---

# eBay API Integration on Truto



**Category:** E-Commerce  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 299 tools for eBay that AI agents can call directly.

- **e_bay_ad_bids_bulk_update** — This method updates the bid percentage (also known as the "ad rate") for the specified ad in the specified campaign. In the request, supply the campaign_id and ad_id as path parameters, and supply the new bidPercentage value in the payload of the call. Required: campaign_id, ad_id.
- **e_bay_ad_group_bid_suggestions_search** — This method allows sellers to retrieve the suggested bids for input keywords and match type. Required: campaign_id, ad_group_id.
- **e_bay_ad_group_keyword_suggestions_search** — This method allows sellers to retrieve a list of keyword ideas to be targeted for Promoted Listings campaigns. Required: campaign_id, ad_group_id.
- **list_all_e_bay_ad_groups** — This method retrieves ad groups for the specified campaigns. Each campaign can only have one ad group. In the request, supply the campaign_ids as path parameters. Call getCampaigns to retrieve a list of the current campaign IDs for a seller. Required: campaign_id. The connector follows eBay's next link through every page.
- **create_a_e_bay_ad_group** — This method adds an ad group to an existing priority strategy campaign that uses manual targeting. Required: campaign_id. Returns {}: the new id is the last part of the location response header (or use ad_groups list).
- **get_single_e_bay_ad_group_by_id** — This method retrieves the details of a specified ad group, such as the ad group’s default bid and status. In the request, specify the campaign_id and ad_group_id as path parameters. Required: id, campaign_id.
- **update_a_e_bay_ad_group_by_id** — This method updates the ad group associated with a campaign. With this method, you can modify the default bid for the ad group, change the state of the ad group, or change the name of the ad group. Required: id, campaign_id.
- **list_all_e_bay_ad_report_metadata** — This call retrieves information that details the fields used in each of the Promoted Listings reports. Use the returned information to configure the different types of Promoted Listings reports.
- **get_single_e_bay_ad_report_metadatum_by_id** — This call retrieves metadata that details the fields used by a specific Promoted Listings report type. Use the report_type path parameter to indicate metadata to retrieve. This method does not use a request payload. Required: id.
- **list_all_e_bay_ad_report_tasks** — This method returns information on all the existing report tasks related to a seller. Use the report_task_statuses query parameter to control which reports to return. You can paginate the result set by specifying a limit, which dictates how many report tasks to return on each page of the response. The connector follows eBay's next link through every page.
- **create_a_e_bay_ad_report_task** — This method creates a report task, which generates a Promoted Listings report based on the values specified in the call.
- **get_single_e_bay_ad_report_task_by_id** — This call returns the details of a specific Promoted Listings report task, as specified by the report_task_id path parameter. Required: id.
- **delete_a_e_bay_ad_report_task_by_id** — This call deletes the report task specified by the report_task_id path parameter. This method also deletes any reports generated by the report task. Report task IDs are generated by eBay when you call createReportTask. Get a complete list of a seller's report-task IDs by calling getReportTasks. Important!. Required: id.
- **get_single_e_bay_ad_report_by_id** — This call downloads the report as specified by the report_id path parameter. Call createReportTask to schedule and generate a Promoted Listings report. All date values are returned in UTC format ( yyyy-MM-ddThh:mm:ss sssZ). Important!. Required: id. Returns a file (binary or tab-separated), not JSON.
- **e_bay_ads_bulk_create_by_inventory_reference** — This method adds multiple listings that are managed with the Inventory API to an existing Promoted Listings campaign. For general strategy campaigns using the Cost Per Sale (CPS) model, bulk ads may be directly created for the listing. Required: campaign_id.
- **e_bay_ads_bulk_create** — This method adds multiple listings to an existing Promoted Listings campaign using listingId values generated by the Trading API or Inventory API, or using values generated by an ad group ID. For general strategy campaigns using the Cost Per Sale (CPS) funding model, bulk ads may be directly created for the listing. Required: campaign_id.
- **e_bay_ads_bulk_delete_by_inventory_reference** — This method works with listings created with the Inventory API. The method deletes a set of ads, as specified by a list of inventory reference IDs, from the specified campaign. Inventory reference IDs are seller-defined IDs that are used with the Inventory API. Required: campaign_id.
- **e_bay_ads_bulk_delete** — This method works with listing IDs created with either the Trading API or the Inventory API. The method deletes a set of ads, as specified by a list of listingID values from a Promoted Listings campaign. Required: campaign_id.
- **e_bay_ads_bulk_update_bid_by_inventory_reference** — This method works with listings created with either the Trading API or the Inventory API. The method updates the bidPercentage values for a set of ads associated with the specified campaign. Required: campaign_id.
- **e_bay_ads_bulk_update_bid** — This method works with listings created with either the Trading API or the Inventory API. The method updates the bidPercentage values for a set of ads associated with the specified campaign. Required: campaign_id.
- **e_bay_ads_bulk_update_status** — This method works with listings created with either the Trading API or the Inventory API. This method updates the status of ads in bulk. Specify the campaign_id you want to update as a URI parameter, and configure the adGroupStatus in the request payload. Required: campaign_id.
- **e_bay_ads_bulk_update_status_by_listing_id** — The method updates the status of ads in bulk, based on listing ID values. Specify the campaign_id as a path parameter and supply a set of listing IDs with their updated adStatus values in the request body. An eBay listing ID is generated when a listing is created with the Trading API. Required: campaign_id.
- **list_all_e_bay_ads** — This method retrieves Promoted Listings ads that are associated with listings created with either the Trading API or the Inventory API. The method retrieves ads related to the specified campaign. Specify the Promoted Listings campaign to target with the campaign_id path parameter. Required: campaign_id. The connector follows eBay's next link through every page.
- **create_a_e_bay_ad** — This method adds a listing to an existing Promoted Listings campaign using a listingId value generated by the Trading API or Inventory API, or using a value generated by . Required: campaign_id. Returns {}: the new id is the last part of the location response header (or use ads list).
- **get_single_e_bay_ad_by_id** — This method retrieves the specified ad from the specified campaign. In the request, supply the campaign_id and ad_id as path parameters. Call getCampaigns to retrieve a list of the seller's current campaign IDs and call getAds to retrieve their current ad IDs. Required: id, campaign_id.
- **delete_a_e_bay_ad_by_id** — This method removes the specified ad from the specified campaign. Pass the ID of the ad to delete with the ID of the campaign associated with the ad as path parameters to the call. Call getCampaigns to get the current list of the seller's campaign IDs. Required: id, campaign_id.
- **list_all_e_bay_advertising_eligibilities** — This method allows developers to check the seller eligibility status for eBay advertising programs. Required: ebay_marketplace_id.
- **list_all_e_bay_automotive_parts_compatibility_policies** — This method returns the eBay policies that define how to list automotive parts compatibility items in the categories of the specified marketplace. By default, this method returns all categories that support parts compatibility. Required: marketplace_id.
- **list_all_e_bay_awaiting_feedback_items** — This method retrieves line items awaiting feedback from the user's order partner. You can refine the results using optional filter query parameters, such as item ID, user name, or user role in the transaction. Sorting and pagination features help organize and navigate returned items efficiently. Needs the commerce.feedback scope (add https://api.ebay.com/oauth/api_scope/commerce.feedback to the OAuth scopes if the app's keyset has it). The connector follows eBay's next link through every page.

- **list_all_e_bay_billing_activities** — Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including all Finances API methods. Required: filter. The connector follows eBay's next link through every page.
- **e_bay_campaign_ad_rate_strategies_bulk_update** — This method updates the ad rate strategy for an existing rules-based general strategy ad campaign that uses the Cost Per Sale (CPS) funding model. Specify the campaign_id as a path parameter. You can retrieve the campaign IDs for a seller by calling the getCampaigns method. Required: campaign_id.
- **e_bay_campaign_bidding_strategies_bulk_update** — This method allows sellers to change the bidding strategy for a specified Cost Per Click (CPC) campaign that uses manual targeting. Available bidding strategies are: FIXED When using a fixed bidding strategy, sellers manually assign and adjust keyword bids for the CPC campaign. Required: campaign_id.
- **list_all_e_bay_campaign_budget_suggestions** — This method allows sellers to retrieve the suggested budget for an offsite campaign. Required: ebay_marketplace_id.
- **e_bay_campaign_budgets_bulk_update** — This method updates the daily budget for a priority strategy campaign that uses the Cost Per Click (CPC) funding model. A click occurs when an eBay user finds and clicks on the seller’s listing (within the search results) after using a keyword that the seller has created for the campaign. Required: campaign_id.
- **e_bay_campaign_identifications_bulk_update** — This method can be used to change the name of a campaign, as well as modify the start or end dates. Specify the campaign_id you want to update as a URI parameter, and configure the campaignName and startDate in the request payload. Required: campaign_id.
- **list_all_e_bay_campaign_item_suggestions** — This method allows sellers to obtain ideas for listings, which can be targeted for Promoted Listings campaigns. Required: campaign_id. The connector follows eBay's next link through every page.
- **e_bay_campaigns_clone** — This method clones (makes a copy of) the specified campaign's campaign criterion. Required: campaign_id. Returns {}: the new id is the last part of the location response header (or use campaigns lookup_by_name).
- **list_all_e_bay_campaigns** — This method retrieves the details for all of the seller's defined campaigns. Request parameters can be used to retrieve a specific campaign, such as the campaign's name, the start and end date, the channel, the status, and the funding model (ie, Cost Per Sale (CPS) or Cost Per Click (CPC)). The connector follows eBay's next link through every page.
- **create_a_e_bay_campaign** — This method can be used to create a Promoted Listings general, priority, or offsite campaign. Returns {}: the new id is the last part of the location response header (or use campaigns lookup_by_name).
- **get_single_e_bay_campaign_by_id** — This method retrieves the details of a single campaign, as specified with the campaign_id query parameter. This method returns all the details of a campaign (including the campaign's the selection rules), except the for the listing IDs or inventory reference IDs included in the campaign. Required: id.
- **delete_a_e_bay_campaign_by_id** — This method deletes the campaign specified by the campaign_id query parameter. Call getCampaigns to retrieve the campaign_id and the campaign status ( RUNNING, PAUSED, ENDED, and so on) for all the seller's campaigns. Required: id.
- **e_bay_campaigns_stop** — This method ends an active ( RUNNING) or paused campaign. Specify the campaign you want to end by supplying its campaign ID in a query parameter. Call getCampaigns to retrieve the campaign_id and the campaign status ( RUNNING, PAUSED, ENDED, and so on) for all the seller's campaigns. Required: campaign_id.
- **e_bay_campaigns_lookup_by_ad_reference** — This method retrieves the campaigns containing the listing that is specified using either a listing ID, or an inventory reference ID and inventory reference type pair. The request accepts either a listing_id, or an inventory_reference_id and inventory_reference_type pair, as used in the Inventory API.
- **e_bay_campaigns_lookup_by_name** — This method retrieves the details of a single campaign, as specified with the campaign_name query parameter. Note that the campaign name you specify must be an exact, case-sensitive match of the name of the campaign you want to retrieve. Call getCampaigns to retrieve a list of the seller's campaign names. Required: campaign_name.
- **e_bay_campaigns_pause** — This method pauses an active (RUNNING) campaign. You can restart the campaign by calling resumeCampaign, as long as the campaign's end date is in the future. Call getCampaigns to retrieve the campaign_id and the campaign status ( RUNNING, PAUSED, ENDED, and so on) for all the seller's campaigns. Required: campaign_id.
- **e_bay_campaigns_resume** — This method resumes a paused campaign, as long as its end date is in the future. Supply the campaign_id for the campaign you want to restart as a query parameter in the request. Call getCampaigns to retrieve the campaign_id and the campaign status ( RUNNING, PAUSED, ENDED, and so on) for all the seller's campaigns. Required: campaign_id.
- **e_bay_catalog_product_compatibilities_search** — This method is used to retrieve all available item compatibility details for the specified product. Item compatibility details can be used to see the properties for which an item is compatible. Required: ebay_marketplace_id.
- **get_single_e_bay_catalog_product_by_id** — This method retrieves details of the catalog product identified by the eBay product identifier (ePID) specified in the request. These details include the product's title and description, aspects and their values, associated images, applicable category IDs, and any recognized identifiers that apply to the product. Required: id.
- **e_bay_catalog_products_search** — This method searches for and retrieves summaries of one or more products in the eBay catalog that match the search criteria provided by a seller. The seller can use the summaries to select the product in the eBay catalog that corresponds to the item that the seller wants to offer for sale. Returns one page (limit, default 50): request further pages with offset; the response's next link holds the next page's query.

- **list_all_e_bay_category_compatibility_properties** — This call retrieves the compatible vehicle aspects that are used to define a motor vehicle that is compatible with a motor vehicle part or accessory. Required: category_tree_id, category_id.
- **list_all_e_bay_category_compatibility_property_values** — This call retrieves applicable compatible vehicle property values based on the specified eBay marketplace, specified eBay category, and filters used in the request. Compatible vehicle properties are returned in the compatibilityProperties name field of a getCompatibilityProperties response. Required: category_tree_id, compatibility_property, category_id.
- **list_all_e_bay_category_item_aspects** — This call returns a list of aspects that are appropriate or necessary for accurately describing items in the specified leaf category. Each aspect identifies an item attribute for which the seller will be required or encouraged to provide a value (or variation values) when offering an item in that category on eBay. Required: category_tree_id, category_id.
- **list_all_e_bay_category_policies** — This method returns eBay category policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review. Required: marketplace_id.
- **list_all_e_bay_category_subtrees** — This call retrieves the details of all nodes of the category tree hierarchy (the subtree) below a specified category of a category tree. You identify the tree using the category_tree_id parameter, which was returned by the getDefaultCategoryTreeId call in the categoryTreeId field. Required: category_tree_id, category_id.
- **list_all_e_bay_category_suggestions** — This call returns an array of category tree leaf nodes in the specified category tree that are considered by eBay to most closely correspond to the query string q. Required: category_tree_id, q.
- **get_single_e_bay_category_tree_by_id** — This method retrieves the complete category tree that is identified by the category_tree_id parameter. The value of category_tree_id was returned by the getDefaultCategoryTreeId method in the categoryTreeId field. Required: id.
- **list_all_e_bay_classified_ad_policies** — This method returns eBay classified ad policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review. Required: marketplace_id.
- **e_bay_compatibilities_search** — This method is used to retrieve all compatible application name-value pairs for a part based on the provided specification(s). The part's relevant dimensions and/or characteristics can be provided through the specifications container. Required: ebay_marketplace_id.
- **e_bay_compatibility_property_names_search** — This method is used to retrieve product compatibility property names for the specified compatibility-enabled category. Required: ebay_marketplace_id.
- **e_bay_compatibility_property_values_search** — This method is used to retrieve product compatibility property values associated with a single property name, in the specified category. Required: ebay_marketplace_id.
- **e_bay_conversations_bulk_update** — This method can be used to update the conversationStatus of up to 10 conversations. The conversationId, existing conversationType, and updated conversationStatus for each conversation to modify are required in the conversations array. Important!. Needs the commerce.message scope (add https://api.ebay.com/oauth/api_scope/commerce.message to the OAuth scopes if the app's keyset has it).

- **get_single_e_bay_conversation_by_id** — This method can be used to retrieve messages within a specific conversation. The conversation_id of the conversation for which to retrieve messages is required as path parameters, and the and conversation_type of the conversation is required as a query parameter. Required: id, conversation_type. Needs the commerce.message scope (add https://api.ebay.com/oauth/api_scope/commerce.message to the OAuth scopes if the app's keyset has it). Returns one page of messages: use limit / offset for more.

- **list_all_e_bay_conversations** — This method can be used to retrieve one or more conversations associated with a user. The conversation_type query parameter is required when using this method to specify if the retrieved conversations are from eBay or from members. Required: conversation_type. Needs the commerce.message scope (add https://api.ebay.com/oauth/api_scope/commerce.message to the OAuth scopes if the app's keyset has it). The connector follows eBay's next link through every page.

- **update_a_e_bay_conversation_by_id** — This method can be used to update the conversationStatus or the read status of a specified conversation. The conversationId of the conversation to modify, as well as the existing conversationType of the specified conversation are required as part of the request payload. Important!. Needs the commerce.message scope (add https://api.ebay.com/oauth/api_scope/commerce.message to the OAuth scopes if the app's keyset has it).

- **list_all_e_bay_currencies** — This method returns the default currency used by the eBay marketplace specified in the request. This is the currency that the seller should use when providing price data for this marketplace through listing APIs. Required: marketplace_id.
- **list_all_e_bay_custom_policies** — This method retrieves the list of custom policies defined for a seller's account. To limit the returned custom policies, specify the policy_types query parameter. The connector follows eBay's next link through every page.
- **create_a_e_bay_custom_policy** — This method creates a new custom policy that specifies the seller's terms for complying with local governmental regulations. Each Custom Policy targets a policyType. Returns {}: the new id is the last part of the location response header (or use custom_policies list).
- **get_single_e_bay_custom_policy_by_id** — This method retrieves the custom policy specified by the custom_policy_id path parameter. Required: id.
- **update_a_e_bay_custom_policy_by_id** — This method updates an existing custom policy specified by the custom_policy_id path parameter. Since this method overwrites the policy's name, label, and description fields, always include the complete and current text of all three policy fields in the request payload, even if they are not being updated. Required: id.
- **list_all_e_bay_customer_service_metric_tasks** — Use this method to return an array of customer service metric tasks. You can limit the tasks returned by specifying a date range. Required: feed_type. The connector follows eBay's next link through every page.
- **create_a_e_bay_customer_service_metric_task** — Use this method to create a customer service metrics download task with filter criteria for the customer service metrics report. When using this method, specify the feedType and filterCriteria including both evaluationMarketplaceId and customerServiceMetricType for the report. Required: accept_language.
- **get_single_e_bay_customer_service_metric_task_by_id** — Use this method to retrieve customer service metric task details for the specified task. The input is task_id. Required: id.
- **list_all_e_bay_customer_service_metrics** — Use this method to retrieve a seller's performance and rating for the customer service metric. Control the response from the getCustomerServiceMetric method using the following path and query parameters: customer_service_metric_type controls the type of customer service transactions evaluated for the metric rating. Required: customer_service_metric_type, evaluation_type, evaluation_marketplace_id.
- **list_all_e_bay_default_category_trees** — A given eBay marketplace might use multiple category trees, but one of those trees is considered to be the default for that marketplace. This call retrieves a reference to the default category tree associated with the specified eBay marketplace ID. Required: marketplace_id.
- **create_a_e_bay_document_import** — This method downloads a document from the provided URL and adds that document to the user's account. This method requires the URL of the document, the type of document to be uploaded, and the language(s) that the document contains.
- **create_a_e_bay_document_upload** — This method associates the specified file with the specified document ID and uploads the input file. After the file has been uploaded, the processing of the file begins. Supported file types include PDF,.JPEG/.JPG, and PNG, with a maximum file size of 10 MB (10485760 bytes). Required: document_id.
- **create_a_e_bay_document** — This method stages a document to be uploaded, and requires the type of document to be uploaded, and the language(s) that the document contains. A successful call returns a documentId value that is then used as a path parameter in an uploadDocument call.
- **get_single_e_bay_document_by_id** — This method retrieves the current status and metadata of the specified document. Important! The document ID value returned in the response payload of the createDocument method is a required input path parameter for this method. See Managing documents for additional information. Required: id.
- **list_all_e_bay_email_campaign_audiences** — This method retrieves all available email newsletter audiences for the email campaign type specified by the emailCampaignType path parameter. Use the optional limit and offset path parameters to paginate the results and to control which records are returned, respectively. Required: emailCampaignType. The connector follows eBay's next link through every page.
- **list_all_e_bay_email_campaign_previews** — This method returns a preview of the email sent by the email campaign indicated by the email_campaign_id path parameter. Call getEmailCampaigns to obtain a list of email campaigns. Use the emailCampaignId value of the desired email campaign as the email_campaign_id path parameter value. Required: email_campaign_id.
- **list_all_e_bay_email_campaign_reports** — This method returns the seller's email campaign performance report for a time period specified by the startDate and endDate path parameters. The maximum date range for a report retrieved by this method is one year. Required: endDate, startDate.
- **list_all_e_bay_email_campaigns** — This method retrieves a list of email campaigns from a seller's eBay store. Users can filter the results by email campaign type, email campaign status, and marketplace ID using the q query parameter. The connector follows eBay's next link through every page.
- **create_a_e_bay_email_campaign** — This method creates a new email campaign. An eBay store owner can create six different types of email campaigns: Welcome, New products & collections, Coupon, Sale event + markdown, Order discount, and Volume pricing. Required: ebay_marketplace_id.
- **get_single_e_bay_email_campaign_by_id** — This method returns the details of a single email campaign specified by the email_campaign_id path parameter. Call getEmailCampaigns to retrieve a list of all email campaigns from a seller's eBay store. Required: id.
- **update_a_e_bay_email_campaign_by_id** — This method lets users update an existing email campaign. Pass the emailCampaignId in the request URL and specify the changes to field values in the request payload. Required: id.
- **delete_a_e_bay_email_campaign_by_id** — This method deletes the email campaign specified by the email_campaign_id path parameter. Call getEmailCampaigns to retrieve all of the seller's email campaigns. Use the email_campaign_id of the desired email campaign in the response as the path parameter for this request. Required: id.
- **list_all_e_bay_exclude_shipping_locations** — This method retrieves a list of locations that the seller can use as excluded shipping locations within their listings or in their fulfillment business policies for the specified marketplace. These are locations that a seller designates as areas where they will not ship items. Required: marketplace_id.
- **list_all_e_bay_expired_categories** — This method retrieves the mappings of expired leaf categories in the specified category tree to their corresponding active leaf categories. Note that in some cases, several expired categories are mapped to a single active category. Required: category_tree_id.
- **list_all_e_bay_extended_producer_responsibility_policies** — This method returns the Extended Producer Responsibility policies for one, multiple, or all eBay categories in an eBay marketplace. Required: marketplace_id.
- **list_all_e_bay_feedback** — This method enables users to retrieve feedback for any specified user ID and feedback type (sent or received). You can refine the results using optional query parameters such as its feedback ID, listing ID, or order line item ID, or applying one or more filters. Required: feedback_type, user_id. Needs the commerce.feedback scope (add https://api.ebay.com/oauth/api_scope/commerce.feedback to the OAuth scopes if the app's keyset has it). The connector follows eBay's next link through every page.

- **create_a_e_bay_feedback** — This method creates and submits feedback to the user's order partner for a line item in the order. For each order, the order partner is the other participant in the transaction, either the buyer or seller, depending on the eBay user associated with the user token. Needs the commerce.feedback scope (add https://api.ebay.com/oauth/api_scope/commerce.feedback to the OAuth scopes if the app's keyset has it).

- **list_all_e_bay_feedback_rating_summaries** — This method provides a detailed overview of feedback ratings associated with a user in the eBay marketplace. Specify a user ID and apply filters to retrieve summarized feedback data categorized by rating types and user roles. Required: filter, user_id. Needs the commerce.feedback scope (add https://api.ebay.com/oauth/api_scope/commerce.feedback to the OAuth scopes if the app's keyset has it).

- **create_a_e_bay_feedback_response** — This method allows users to respond to feedback provided by the order partner for a specific line item in an order. For each order, the order partner is the other participant in the transaction, either the buyer or seller, depending on the eBay user associated with the user token. Needs the commerce.feedback scope (add https://api.ebay.com/oauth/api_scope/commerce.feedback to the OAuth scopes if the app's keyset has it).

- **create_a_e_bay_fulfillment_policy** — This method creates a new fulfillment policy for an eBay marketplace where the policy encapsulates seller's terms for fulfilling item purchases. Fulfillment policies include the shipment options that the seller offers to buyers.
- **get_single_e_bay_fulfillment_policy_by_id** — This method retrieves the complete details of a fulfillment policy. Supply the ID of the policy you want to retrieve using the fulfillmentPolicyId path parameter. Required: id.
- **update_a_e_bay_fulfillment_policy_by_id** — This method updates an existing fulfillment policy. Specify the policy you want to update using the fulfillment_policy_id path parameter. Supply a complete policy payload with the updates you want to make; this call overwrites the existing policy with the new details specified in the payload. Required: id.
- **delete_a_e_bay_fulfillment_policy_by_id** — This method deletes a fulfillment policy. Supply the ID of the policy you want to delete in the fulfillmentPolicyId path parameter. Required: id.
- **list_all_e_bay_fulfillment_policies** — This method retrieves all the fulfillment policies configured for the marketplace you specify using the marketplace_id query parameter. Required: marketplace_id. The connector follows eBay's next link through every page.
- **e_bay_fulfillment_policies_lookup_by_name** — This method retrieves the details for a specific fulfillment policy. In the request, supply both the policy name and its associated marketplace_id as query parameters. Required: marketplace_id, name.
- **list_all_e_bay_handling_times** — This method retrieves a list of supported handling times for the specified marketplace. The handling time returned specifies the maximum number of business days the eBay site allows for shipping an item to domestic buyers after receiving a cleared payment. Handling times apply to both domestic and international orders. Required: marketplace_id.
- **list_all_e_bay_hazardous_materials_labels** — This method returns hazardous materials label information for the specified eBay marketplace. The information includes IDs, descriptions, and URLs (as applicable) for the available signal words, statements, and pictograms. The returned statements are localized for the default language of the marketplace. Required: marketplace_id.
- **create_a_e_bay_image_upload** — This method uploads a picture file to eBay Picture Services (EPS) using multipart/form-data. All images must comply with eBay's picture requirements, such as dimension and file size restrictions. For more information, see Picture policy. The image formats supported are JPG, GIF, PNG, BMP, TIFF, AVIF, HEIC, and WEBP.
- **create_a_e_bay_image** — This method uploads a picture to eBay Picture Services (EPS) from the specified URL. Specify the location of the picture on an external web server through the imageUrl field. All images must comply with eBay’s picture requirements, such as dimension and file size restrictions. For more information, see Picture policy.
- **get_single_e_bay_image_by_id** — This method retrieves an EPS image URL and its expiration details for the unique identifier specified in the path parameter image_id. Use the retrieved EPS image URL to add the image to a listing through the Inventory API or the Trading API. See Managing images for additional details. Required: id.
- **create_a_e_bay_interested_buyer_offer** — This method sends eligible buyers offers to purchase items in a listing at a discount. When a buyer has shown interest in a listing, they become "eligible" to receive a seller-initiated offer to purchase the item(s). Sellers use findEligibleItems to get the set of listings that have interested buyers. Required: ebay_marketplace_id.
- **get_single_e_bay_inventory_item_group_by_id** — This call retrieves the inventory item group for a given inventoryItemGroupKey value. The inventoryItemGroupKey value is passed in at the end of the call URI. Required: id.
- **update_a_e_bay_inventory_item_group_by_id** — This call creates a new inventory item group or updates an existing inventory item group. Required: id, content_language.
- **delete_a_e_bay_inventory_item_group_by_id** — This call deletes the inventory item group for a given inventoryItemGroupKey value. Required: id.
- **e_bay_inventory_item_groups_publish** — This call is used to convert all unpublished offers associated with an inventory item group into an active, multiple-variation listing. Important!.
- **e_bay_inventory_item_groups_unpublish** — This call is used to end a multiple-variation eBay listing that is associated with the specified inventory item group. This call only ends multiple-variation eBay listing associated with the inventory item group but does not delete the inventory item group object.
- **e_bay_inventory_items_bulk_upsert** — This call can be used to create and/or update up to 25 new inventory item records. Required: content_language.
- **e_bay_inventory_items_bulk_get** — This call retrieves up to 25 inventory item records. The SKU value of each inventory item record to retrieve is specified in the request payload. For those who prefer to retrieve only one inventory item record by SKU value, the getInventoryItem method can be used.
- **e_bay_inventory_items_bulk_update_price_quantity** — This call is used by the seller to update the total ship-to-home quantity of one inventory item, and/or to update the price and/or quantity of one or more offers associated with one inventory item. Up to 25 offers associated with an inventory item may be updated with one bulkUpdatePriceQuantity call.
- **get_single_e_bay_inventory_item_by_id** — This call retrieves the inventory item record for a given SKU. The SKU value is passed in at the end of the call URI. There is no request payload for this call. The authorization header is the only required HTTP header for this call, and it is required for all Inventory API calls. Required: id.
- **update_a_e_bay_inventory_item_by_id** — This call creates a new inventory item record or replaces an existing inventory item record. Required: id, content_language.
- **delete_a_e_bay_inventory_item_by_id** — This call is used to delete an inventory item record associated with a specified SKU. Required: id.
- **list_all_e_bay_inventory_items** — This call retrieves all inventory item records defined for the seller's account. The limit query parameter allows the seller to control how many records are returned per page, and the offset query parameter is used to retrieve a specific page of records. The connector follows eBay's next link through every page.
- **e_bay_inventory_location_details_bulk_update** — Use this call to update location details for an existing inventory location. Specify the inventory location you want to update using the merchantLocationKey path parameter. Required: merchant_location_key.
- **get_single_e_bay_inventory_location_by_id** — This call retrieves all defined details of the inventory location that is specified by the merchantLocationKey path parameter. A successful call will return an HTTP status value of 200 OK. Required: id.
- **create_a_e_bay_inventory_location** — Use this call to create a new inventory location. In order to create and publish an offer (and create an eBay listing), a seller must have at least one location, as every offer must be associated with at least one location. Important!. Required: merchant_location_key.
- **delete_a_e_bay_inventory_location_by_id** — This call deletes the inventory location that is specified in the merchantLocationKey path parameter. Note that deleting a location will not affect any active eBay listings associated with the deleted location, but the seller will not be able modify the offers associated with the location once it is deleted. Required: id.
- **e_bay_inventory_locations_disable** — This call disables the inventory location that is specified in the merchantLocationKey path parameter. Sellers can not load/modify inventory to disabled locations. Required: merchant_location_key.
- **e_bay_inventory_locations_enable** — This call enables a disabled inventory location that is specified in the merchantLocationKey path parameter. Once a disabled location is enabled, sellers can start loading/modifying inventory to that location. A successful call will return an HTTP status value of 200 OK. Required: merchant_location_key.
- **list_all_e_bay_inventory_locations** — This call retrieves all defined details for every inventory location associated with the seller's account. There are no required parameters for this call and no request payload. However, there are two optional query parameters, limit and offset. The connector follows eBay's next link through every page.
- **create_a_e_bay_inventory_reference_ad** — This method adds a listing that is managed with the Inventory API to an existing Promoted Listings campaign. For general strategy campaigns using the Cost Per Sale (CPS) funding model, an ad may be directly created for the listing. For each listing specified in the request, this method: Creates an ad for the listing. Required: campaign_id.
- **e_bay_inventory_reference_ads_bulk_delete** — This method works with listings that are managed with the Inventory API. The method deletes ads using a list of seller-defined inventory reference IDs, used with the Inventory API, that are associated with the specified campaign ID. Required: campaign_id.
- **list_all_e_bay_inventory_reference_ads** — This method retrieves Promoted Listings ads associated with listings that are managed with the Inventory API from the specified campaign. Supply the campaign_id as a path parameter and use query parameters to specify the inventory_reference_id and inventory_reference_type pairs. Required: campaign_id, inventory_reference_id, inventory_reference_type.
- **list_all_e_bay_inventory_tasks** — This method searches for multiple tasks of a specific feed type, and includes date filters and pagination. eBay requires feed_type or schedule_id. The connector follows eBay's next link through every page.
- **create_a_e_bay_inventory_task** — This method creates an inventory-related download task for a specified feed type with optional filter criteria. When using this method, specify the feedType. This method returns the location response header containing the getInventoryTask call URI to retrieve the inventory task you just created.
- **get_single_e_bay_inventory_task_by_id** — This method retrieves the task details and status of the specified inventory-related task. The input is task_id. Required: id.
- **list_all_e_bay_item_condition_policies** — This method returns item condition metadata on one, multiple, or all eBay categories on an eBay marketplace. This metadata consists of the different item conditions (with IDs) that an eBay category supports, and a boolean to indicate if an eBay category requires an item condition. Required: marketplace_id.
- **create_a_e_bay_item_price_markdown** — This method creates an item price markdown discount (know simply as a "markdown discount") where a discount amount is applied directly to the items included in the discou. Returns {}: the new id is the last part of the location response header (or use promotions list).
- **get_single_e_bay_item_price_markdown_by_id** — This method returns the complete details of the item price markdown discount that's indicated by the promotion_id path parameter. Call getPromotions to retrieve the IDs of a seller's discounts. Required: id.
- **update_a_e_bay_item_price_markdown_by_id** — This method updates the specified item price markdown discount with the new configuration that you supply in the payload of the request. Specify the discount you want to update using the promotion_id path parameter. Call getPromotions to retrieve the IDs of a seller's discounts. Required: id.
- **delete_a_e_bay_item_price_markdown_by_id** — This method deletes the item price markdown discount specified by the promotion_id path parameter. Call getPromotions to retrieve the IDs of a seller's discounts. You can delete any discount with the exception of those that are currently active (RUNNING). Required: id.
- **create_a_e_bay_item_promotion** — This method creates an item discount, where the buyer receives a discount when they meet the specific buying criteria. Returns {}: the new id is the last part of the location response header (or use promotions list).
- **get_single_e_bay_item_promotion_by_id** — This method returns the complete details of the threshold discount specified by the promotion_id path parameter. Call getPromotions to retrieve the IDs of a seller's discounts. Required: id.
- **update_a_e_bay_item_promotion_by_id** — This method updates the specified threshold discount with the new configuration that you supply in the request. Indicate the discount you want to update using the promotion_id path parameter. Call getPromotions to retrieve the IDs of a seller's discounts. Required: id.
- **delete_a_e_bay_item_promotion_by_id** — This method deletes the threshold discount specified by the promotion_id path parameter. Call getPromotions to retrieve the IDs of a seller's discounts. You can delete any discount with the exception of those that are currently active (RUNNING). Required: id.
- **e_bay_keywords_bulk_create** — This method adds keywords, in bulk, to an existing priority strategy ad group in a campaign that uses manual targeting. This method also sets the CPC rate for each keyword, depending on the selected bidding strategy, as follows: FIXED: If the seller provides a keyword bid, that bid value will be used. Required: campaign_id.
- **e_bay_keywords_bulk_update** — This method updates the bids and statuses of keywords, in bulk, for an existing priority strategy campaign. In the request, supply the campaign_id as a path parameter. Call the getCampaigns method to retrieve a list of current campaign IDs for a specified seller. Required: campaign_id.
- **list_all_e_bay_keywords** — This method can be used to retrieve all of the keywords for ad groups in priority strategy campaigns that use the Cost Per Click (CPC) funding model. In the request, specify the campaign_id as a path parameter. Required: campaign_id. The connector follows eBay's next link through every page.
- **create_a_e_bay_keyword** — This method creates keywords using a specified campaign ID for an existing priority strategy campaign that uses manual targeting. Required: campaign_id. Returns {}: the new id is the last part of the location response header (or use keywords list).
- **get_single_e_bay_keyword_by_id** — This method retrieves details on a specific keyword from an ad group within a priority strategy campaign that uses the Cost Per Click (CPC) funding model. In the request, specify the campaign_id and keyword_id as path parameters. Required: id, campaign_id.
- **update_a_e_bay_keyword_by_id** — This method updates keywords using a campaign ID and keyword ID for an existing priority strategy campaign. In the request, specify the campaign_id and keyword_id as path parameters. Required: id, campaign_id.
- **list_all_e_bay_kyc_checks** — This method was originally created to see which onboarding requirements were still pending for sellers being onboarded for eBay managed payments, but now that all seller accounts are onboarded globally, this method should now just return an empty payload with a 204 No Content HTTP status code.
- **e_bay_listing_recommendations_search** — The find method currently returns information for a single recommendation type ( AD) which contains information that sellers can use to configure Promoted Listings ad campaigns. Required: ebay_marketplace_id.
- **list_all_e_bay_listing_structure_policies** — This method returns the eBay policies that define the allowed listing structures for the categories of a specific marketplace. The listing-structure policies currently pertain to whether or not you can list items with variations. By default, this method returns the entire category tree for the specified marketplace. Required: marketplace_id.
- **list_all_e_bay_listing_type_policies** — This method returns eBay listing type policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review. Required: marketplace_id.
- **e_bay_listings_bulk_migrate** — This call is used to convert existing eBay Listings to the corresponding Inventory API objects. If an eBay listing is successfully migrated to the Inventory API model, new Inventory Location, Inventory Item, and Offer objects are created.
- **list_all_e_bay_marketplace_return_policies** — This method returns the eBay policies that define whether or not you must include a return policy for the items you list in the categories of a specific marketplace, plus the guidelines for creating domestic and international return policies in the different eBay categories. Required: marketplace_id.
- **list_all_e_bay_marketplace_shipping_policies** — This method returns eBay shipping policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review. Required: marketplace_id.
- **e_bay_max_cpc_suggestions_search** — This method allows sellers to retrieve the suggested maximum cost-per-click value for a smart targeting campaign. This value is required when creating a smart targeting campaign and indicates the maximum amount for which the eBay suggested bid can be adjusted.
- **create_a_e_bay_message** — This method can be used to start a conversation with another user or send a message in an existing conversation with another user based on the information provided in the request. To send a message, one of the conversationId or otherPartyUsername request fields are required. Needs the commerce.message scope (add https://api.ebay.com/oauth/api_scope/commerce.message to the OAuth scopes if the app's keyset has it).

- **list_all_e_bay_motors_listing_policies** — This method returns eBay Motors policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review. Required: marketplace_id.
- **e_bay_multi_compatibility_property_values_search** — This method is used to retrieve product compatibility property values associated with multiple property names, in the specified category. Required: ebay_marketplace_id.
- **e_bay_negative_keywords_bulk_create** — This method adds negative keywords, in bulk, to an existing ad group in a priority strategy campaign that uses manual targeting. Specify the campaignId and adGroupId in the request body, along with the negativeKeywordText and negativeKeywordMatchType.
- **e_bay_negative_keywords_bulk_update** — This method updates the statuses of existing negative keywords, in bulk. Specify the negativeKeywordId and negativeKeywordStatus in the request body.
- **list_all_e_bay_negative_keywords** — This method can be used to retrieve all of the negative keywords for ad groups in priority strategy campaigns that use the Cost Per Click (CPC) funding model. The results can be filtered using the campaign_ids, ad_group_ids, and negative_keyword_status query parameters. eBay requires ad_group_ids (with campaign_ids). The connector follows eBay's next link through every page.
- **create_a_e_bay_negative_keyword** — This method adds a negative keyword to an existing ad group in a priority strategy campaign that uses manual targeting. Returns {}: the new id is the last part of the location response header (or use negative_keywords list).
- **get_single_e_bay_negative_keyword_by_id** — This method retrieves details on a specific negative keyword. In the request, specify the negative_keyword_id as a path parameter. Required: id.
- **update_a_e_bay_negative_keyword_by_id** — This method updates the status of an existing negative keyword. Specify the negative_keyword_id as a path parameter, and specify the negativeKeywordStatus in the request body. Required: id.
- **list_all_e_bay_negotiated_price_policies** — This method returns the eBay policies that define the supported negotiated price features (like "best offer") for the categories of a specific marketplace. By default, this method returns the entire category tree for the specified marketplace. Required: marketplace_id.
- **list_all_e_bay_notification_configs** — This method allows applications to retrieve a previously created configuration.
- **e_bay_notification_configs_bulk_update** — This method allows applications to create a new configuration or update an existing configuration. This app-level configuration allows developers to set up alerts.
- **list_all_e_bay_notification_destinations** — This method allows applications to retrieve a paginated collection of destination resources and related details. The details include the destination names, statuses, and configurations, including the endpoints and verification tokens. The connector follows eBay's next link through every page.
- **create_a_e_bay_notification_destination** — This method allows applications to create a destination. A destination is an endpoint that receives HTTP push notifications. Returns {}: the new id is the last part of the location response header (or use notification_destinations list).
- **get_single_e_bay_notification_destination_by_id** — This method allows applications to fetch the details for a destination. The details include the destination name, status, and configuration, including the endpoint and verification token. Required: id.
- **update_a_e_bay_notification_destination_by_id** — This method allows applications to update a destination. Required: id.
- **delete_a_e_bay_notification_destination_by_id** — This method provides applications a way to delete a destination. The same destination ID can be used by many destinations. Trying to delete an active destination results in an error. You can disable a subscription, and when the destination is no longer in use, you can delete it. Required: id.
- **get_single_e_bay_notification_public_key_by_id** — This method allows users to retrieve a public key using a specified key ID. The public key that is returned in the response payload is used to process and validate eBay notifications. Required: id.
- **create_a_e_bay_notification_subscription_filter** — This method allows applications to create a filter for a subscription. Filters allow applications to only be sent notifications that match a provided criteria. Required: subscription_id. Returns {}: the new id is the last part of the location response header.
- **get_single_e_bay_notification_subscription_filter_by_id** — This method allows applications to retrieve the filter details for the specified subscription filter. Specify the subscription filter to retrieve by using the subscription_id and the filter_id associated with the subscription filter. Required: id, subscription_id.
- **delete_a_e_bay_notification_subscription_filter_by_id** — This method allows applications to disable the active filter on a subscription, so that a new subscription filter may be added. Required: id, subscription_id.
- **create_a_e_bay_notification_subscription_test** — This method triggers a mocked test payload that includes a notification ID, publish date, and so on. Use this method to test your subscription end-to-end. Required: subscription_id.
- **list_all_e_bay_notification_subscriptions** — This method allows applications to retrieve a list of all subscriptions. The list returned is a paginated collection of subscription resources. Subscriptions allow applications to express interest in notifications and keep receiving the information relevant to their business. The connector follows eBay's next link through every page.
- **create_a_e_bay_notification_subscription** — This method allows applications to create a subscription for a topic and supported schema version. Returns {}: the new id is the last part of the location response header (or use notification_subscriptions list).
- **get_single_e_bay_notification_subscription_by_id** — This method allows applications to retrieve subscription details for the specified subscription. Specify the subscription to retrieve using the subscription_id. Use the getSubscriptions method to browse all subscriptions if you do not know the subscription_id. Required: id.
- **update_a_e_bay_notification_subscription_by_id** — This method allows applications to update a subscription. Subscriptions allow applications to express interest in notifications and keep receiving the information relevant to their business. You can pause and restart a subscription. See the disableSubscription and enableSubscription methods. Required: id.
- **delete_a_e_bay_notification_subscription_by_id** — This method allows applications to delete a subscription. Subscriptions can be deleted regardless of status. Required: id.
- **e_bay_notification_subscriptions_disable** — This method disables a subscription, which prevents the subscription from providing notifications. To restart a subscription, call enableSubscription. Required: subscription_id.
- **e_bay_notification_subscriptions_enable** — This method allows applications to enable a disabled subscription. To pause (or disable) an enabled subscription, call disableSubscription. Required: subscription_id.
- **get_single_e_bay_notification_topic_by_id** — This method allows applications to retrieve details for the specified topic. This information includes supported schema versions, formats, and other metadata for the topic. Required: id.
- **list_all_e_bay_notification_topics** — This method returns a paginated collection of all supported topics, along with the details for the topics. This information includes supported schema versions, formats, and other metadata for the topics. The connector follows eBay's next link through every page.
- **list_all_e_bay_offer_eligible_items** — This method evaluates a seller's current listings and returns the set of IDs that are eligible for a seller-initiated discount offer to a buyer. A listing ID is returned only when one or more buyers have shown an "interest" in the listing. Required: ebay_marketplace_id. The connector follows eBay's next link through every page.
- **e_bay_offers_bulk_create** — This call creates multiple offers (up to 25) for specific inventory items on a specific eBay marketplace. Required: content_language.
- **e_bay_offers_bulk_publish** — This call is used to convert unpublished offers (up to 25) into published offers, or live eBay listings. The unique identifier ( offerId) of each offer to publish is passed into the request payload. It is possible that some unpublished offers will be successfully created into eBay listings, but others may fail.
- **list_all_e_bay_offers** — This call retrieves all existing offers for the specified SKU value. The seller has the option of limiting the offers that are retrieved to a specific eBay marketplace, or to a listing format. The authorization header is the only required HTTP header for this call. Required: sku. The connector follows eBay's next link through every page.
- **create_a_e_bay_offer** — This call creates an offer for a specific inventory item on a specific eBay marketplace. Required: content_language.
- **get_single_e_bay_offer_by_id** — This call retrieves a specific published or unpublished offer. The unique identifier of the offer ( offerId) is passed in at the end of the call URI. The authorization header is the only required HTTP header for this call. See the HTTP request headers section for more information. Required: id.
- **update_a_e_bay_offer_by_id** — This call updates an existing offer. An existing offer may be in published state (active eBay listing), or in an unpublished state and yet to be published with the publishOffer call. The unique identifier ( offerId) for the offer to update is passed in at the end of the call URI. Required: id, content_language.
- **delete_a_e_bay_offer_by_id** — If used against an unpublished offer, this call will permanently delete that offer. Required: id.
- **e_bay_offers_lookup_listing_fees** — This call is used to retrieve the expected listing fees for up to 250 unpublished offers. An array of one or more offerId values are passed in under the offers container. In the response payload, all listing fees are grouped by eBay marketplace, and listing fees per offer are not shown.
- **e_bay_offers_publish** — This call is used to convert an unpublished offer into a published offer, or live eBay listing. The unique identifier of the offer ( offerId) is passed in at the end of the call URI. Important!. Required: offer_id.
- **e_bay_offers_unpublish** — This call is used to end a single-variation listing that is associated with the specified offer. This call is used in place of the deleteOffer call if the seller only wants to end the listing associated with the offer but does not want to delete the offer object. Required: offer_id.
- **list_all_e_bay_order_earnings** — This method returns detailed order-level financial data for each order associated with a seller account. The returned order-level financial data includes order earnings, gross amount, expenses, and refunds. Order earnings includes earnings after deducting expenses and refunds from the gross amount. Required: ebay_marketplace_id. The connector follows eBay's next link through every page. Needs the sell.finances.earnings.read scope (add https://api.ebay.com/oauth/api_scope/sell.finances.earnings.read to the OAuth scopes if the app's keyset has it).

- **get_single_e_bay_order_earning_by_id** — This method returns detailed order-level financial data including order earnings, gross amount, expenses, and refunds. Order earnings includes earnings after deducting expenses and refunds from the gross amount. The response returns earnings information only for the order identified by the order_id path parameter. Required: id, ebay_marketplace_id. Needs the sell.finances.earnings.read scope (add https://api.ebay.com/oauth/api_scope/sell.finances.earnings.read to the OAuth scopes if the app's keyset has it).

- **list_all_e_bay_order_earnings_summaries** — This method returns a summarized view of order earnings information for one or more orders associated with a seller account. The method retrieves aggregated data for order earnings after deducting expenses and refunds from the gross amount. You can use this method for high-level financial reporting workflows. Required: ebay_marketplace_id. Needs the sell.finances.earnings.read scope (add https://api.ebay.com/oauth/api_scope/sell.finances.earnings.read to the OAuth scopes if the app's keyset has it).

- **list_all_e_bay_order_tasks** — This method returns the details and status for an array of order tasks based on a specified feed_type or schedule_id. Specifying both feed_type and schedule_id results in an error. Since schedules are based on feed types, you can specify a schedule ( schedule_id) that returns the needed feed_type. eBay requires feed_type or schedule_id. The connector follows eBay's next link through every page.
- **create_a_e_bay_order_task** — This method creates an order download task with filter criteria for the order report. When using this method, specify the feedType, schemaVersion, and filterCriteria for the report. The method returns the location response header containing the getOrderTask call URI to retrieve the order task you just created.
- **get_single_e_bay_order_task_by_id** — This method retrieves the task details and status of the specified task. The input is task_id. For details about how this method is used, see Working with Order Feeds in the Selling Integration Guide. Required: id.
- **get_single_e_bay_order_by_id** — Use this call to retrieve the contents of an order based on its unique identifier, orderId. This value was returned in the getOrders call's orders orderId field when you searched for orders by creation date, modification date, or fulfillment status. Required: id.
- **list_all_e_bay_orders** — Use this method to search for and retrieve one or more orders based on their creation date, last modification date, or fulfillment status using the filter parameter. You can alternatively specify a list of orders using the orderIds parameter. The connector follows eBay's next link through every page.
- **e_bay_orders_refund** — Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including issueRefund. Required: order_id.
- **create_a_e_bay_payment_dispute_acceptance** — This method is used if the seller wishes to accept a payment dispute. The unique identifier of the payment dispute is passed in as a path parameter, and unique identifiers for payment disputes can be retrieved with the getPaymentDisputeSummaries method. Required: payment_dispute_id.
- **list_all_e_bay_payment_dispute_activities** — This method retrieve a log of activity for a payment dispute. The identifier of the payment dispute is passed in as a path parameter. The output includes a timestamp for each action of the payment dispute, from creation to resolution, and all steps in between. Required: payment_dispute_id.
- **create_a_e_bay_payment_dispute_contest** — This method is used if the seller wishes to contest a payment dispute initiated by the buyer. The unique identifier of the payment dispute is passed in as a path parameter, and unique identifiers for payment disputes can be retrieved with the getPaymentDisputeSummaries method. Required: payment_dispute_id.
- **create_a_e_bay_payment_dispute_evidence** — This method is used by the seller to add one or more evidence files to address a payment dispute initiated by the buyer. The unique identifier of the payment dispute is passed in as a path parameter, and unique identifiers for payment disputes can be retrieved with the getPaymentDisputeSummaries method. Required: payment_dispute_id.
- **e_bay_payment_dispute_evidence_bulk_update** — This method is used by the seller to update an existing evidence set for a payment dispute with one or more evidence files. The unique identifier of the payment dispute is passed in as a path parameter, and unique identifiers for payment disputes can be retrieved with the getPaymentDisputeSummaries method. Required: payment_dispute_id.
- **list_all_e_bay_payment_dispute_evidence_contents** — This call retrieves a specific evidence file for a payment dispute. The following three identifying parameters are needed in the call URI: payment_dispute_id: the identifier of the payment dispute. The identifier of each payment dispute is returned in the getPaymentDisputeSummaries response. Required: payment_dispute_id, evidence_id, file_id. Returns a file (binary or tab-separated), not JSON.
- **create_a_e_bay_payment_dispute_evidence_file** — This method is used to upload an evidence file for a contested payment dispute. The unique identifier of the payment dispute is passed in as a path parameter, and unique identifiers for payment disputes can be retrieved with the getPaymentDisputeSummaries method. Required: payment_dispute_id.
- **get_single_e_bay_payment_dispute_by_id** — This method retrieves detailed information on a specific payment dispute. The payment dispute identifier is passed in as path parameter at the end of the call URI. Required: id.
- **list_all_e_bay_payment_disputes** — This method is used retrieve one or more payment disputes filed against the seller. These payment disputes can be open or recently closed. The connector follows eBay's next link through every page.
- **list_all_e_bay_payment_policies** — This method retrieves all the payment business policies configured for the marketplace you specify using the marketplace_id query parameter. Required: marketplace_id. The connector follows eBay's next link through every page.
- **create_a_e_bay_payment_policy** — This method creates a new payment policy where the policy encapsulates seller's terms for order payments. A successful request returns the getPaymentPolicy URI to the new policy in the Location response header and the ID for the new policy is returned in the response payload.
- **get_single_e_bay_payment_policy_by_id** — This method retrieves the complete details of a payment policy. Supply the ID of the policy you want to retrieve using the paymentPolicyId path parameter. Required: id.
- **update_a_e_bay_payment_policy_by_id** — This method updates an existing payment policy. Specify the policy you want to update using the payment_policy_id path parameter. Supply a complete policy payload with the updates you want to make; this call overwrites the existing policy with the new details specified in the payload. Required: id.
- **delete_a_e_bay_payment_policy_by_id** — This method deletes a payment policy. Supply the ID of the policy you want to delete in the paymentPolicyId path parameter. Required: id.
- **e_bay_payment_policies_lookup_by_name** — This method retrieves the details of a specific payment policy. Supply both the policy name and its associated marketplace_id in the request query parameters. Required: marketplace_id, name.
- **list_all_e_bay_payments_program_onboardings** — No longer applicable (eBay): all seller accounts globally have been enabled for the new eBay payment and checkout flow. This method retrieves a seller's onboarding status for a payments program for a specified marketplace. The overall onboarding status of the seller and the status of each onboarding step is returned. Required: marketplace_id, payments_program_type.

- **list_all_e_bay_payments_programs** — No longer applicable (eBay): all seller accounts globally have been enabled for the new eBay payment and checkout flow. This method returns whether or not the user is opted-in to the specified payments program. Sellers opt-in to payments programs by marketplace and you use the marketplace_id path parameter to specify the marketplace of the status flag you want returned. Required: marketplace_id, payments_program_type.

- **list_all_e_bay_payout_summaries** — Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including all Finances API methods. Required: ebay_marketplace_id.
- **get_single_e_bay_payout_by_id** — Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including all Finances API methods. Required: id, ebay_marketplace_id.
- **list_all_e_bay_payouts** — Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including all Finances API methods. Required: ebay_marketplace_id. The connector follows eBay's next link through every page.
- **get_single_e_bay_post_order_document_by_id** — This method downloads the file associated with the specified document ID. Required: id. Returns a file (binary or tab-separated), not JSON. Needs the commerce.post_order.document scope (add https://api.ebay.com/oauth/api_scope/commerce.post_order.document to the OAuth scopes if the app's keyset has it).

- **delete_a_e_bay_post_order_document_by_id** — This method deletes a previously uploaded document by its document ID. Only documents in SUBMITTED state can be removed; documents in the PUBLISHED state cannot be deleted. Important! All documents, whether submitted or published, expire and become inaccessible after their expiration date. Required: id. Needs the commerce.post_order.document scope (add https://api.ebay.com/oauth/api_scope/commerce.post_order.document to the OAuth scopes if the app's keyset has it).

- **create_a_e_bay_post_order_document** — This method uploads a document for post‑order processes. Returns {}: the new id is the last part of the location response header. Needs the commerce.post_order.document scope (add https://api.ebay.com/oauth/api_scope/commerce.post_order.document to the OAuth scopes if the app's keyset has it).

- **list_all_e_bay_privileges** — This method retrieves the 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 amount and quantity they can sell on a given day).
- **list_all_e_bay_product_compatibilities** — This call is used by the seller to retrieve the list of products that are compatible with the inventory item. The SKU value for the inventory item is passed into the call URI, and a successful call with return the compatible vehicle list associated with this inventory item. Required: sku.
- **e_bay_product_compatibilities_bulk_update** — This call is used by the seller to create or replace a list of products that are compatible with the inventory item. The inventory item is identified with a SKU value in the URI. Required: sku, content_language.
- **e_bay_product_compatibilities_bulk_delete** — This call is used by the seller to delete the list of products that are compatible with the inventory item that is associated with the compatible product list. The inventory item is identified with a SKU value in the URI. Required: sku.
- **list_all_e_bay_product_safety_labels** — This method returns product safety label information for the specified eBay marketplace. The information includes IDs, descriptions, and URLs (as applicable) for the available statements and pictograms. The returned statements are localized for the default language of the marketplace. Required: marketplace_id.
- **create_a_e_bay_program_opt_in** — This method opts the seller in to an eBay seller program. Refer to the Account API overview for information about available eBay seller programs.
- **create_a_e_bay_program_opt_out** — This method opts the seller out of a seller program in which they are currently opted in to. A seller can retrieve a list of the seller programs they are opted-in to using the getOptedInPrograms method.
- **list_all_e_bay_programs** — This method gets a list of the seller programs that the seller has opted-in to.
- **list_all_e_bay_promotion_listing_sets** — This method returns the set of listings associated with the promotion_id specified in the path parameter. Call getPromotions to retrieve the IDs of a seller's discounts. Required: promotion_id. The connector follows eBay's next link through every page.
- **list_all_e_bay_promotion_reports** — This method generates a report that lists the seller's running, paused, and ended discounts for the specified eBay marketplace. The result set can be filtered by the discount status and the number of results to return. You can also supply keywords to limit the report to discounts that contain the specified keywords. Required: marketplace_id. The connector follows eBay's next link through every page.
- **list_all_e_bay_promotion_summary_reports** — This method generates a report that summarizes the seller's discounts for the specified eBay marketplace. The report returns information on RUNNING, PAUSED, and ENDED discounts (deleted reports are not returned) and summarizes the seller's campaign performance for all discounts on a given site. Required: marketplace_id.
- **list_all_e_bay_promotions** — This method returns a list of a seller's undeleted discounts. The call returns up to 200 currently-available discounts on the specified marketplace. Required: marketplace_id. The connector follows eBay's next link through every page.
- **e_bay_promotions_pause** — This method pauses a currently-active (RUNNING) threshold discount and changes the state of the discount from RUNNING to PAUSED. Pausing a discount makes the discount temporarily unavailable to buyers and any currently-incomplete transactions will not receive the offer until the discount is resumed. Required: promotion_id.
- **e_bay_promotions_resume** — This method restarts a threshold discount that was previously paused and changes the state of the discount from PAUSED to RUNNING. Only discounts that have been previously paused can be resumed. Required: promotion_id.
- **list_all_e_bay_rate_tables** — This method retrieves a seller's shipping rate tables for the country specified in the country_code query parameter. If you call this method without specifying a country code, the call returns all of the seller's shipping rate tables. The method's response includes a rateTableId for each table defined by the seller.
- **list_all_e_bay_regulatory_policies** — This method returns regulatory policies for one, multiple, or all eBay categories in an eBay marketplace. Required: marketplace_id.
- **list_all_e_bay_return_policies** — This method retrieves all the return policies configured for the marketplace you specify using the marketplace_id query parameter. Required: marketplace_id. The connector follows eBay's next link through every page.
- **create_a_e_bay_return_policy** — This method creates a new return policy where the policy encapsulates seller's terms for returning items. Each policy targets a specific marketplace, and you can create multiple policies for each marketplace. Return policies are not applicable to motor-vehicle listings.
- **get_single_e_bay_return_policy_by_id** — This method retrieves the complete details of the return policy specified by the returnPolicyId path parameter. Required: id.
- **update_a_e_bay_return_policy_by_id** — This method updates an existing return policy. Specify the policy you want to update using the return_policy_id path parameter. Supply a complete policy payload with the updates you want to make; this call overwrites the existing policy with the new details specified in the payload. Required: id.
- **delete_a_e_bay_return_policy_by_id** — This method deletes a return policy. Supply the ID of the policy you want to delete in the returnPolicyId path parameter. Required: id.
- **e_bay_return_policies_lookup_by_name** — This method retrieves the details of a specific return policy. Supply both the policy name and its associated marketplace_id in the request query parameters. Required: marketplace_id, name.
- **list_all_e_bay_sales_tax_jurisdictions** — This method retrieves all sales-tax jurisdictions for the country specified in the countryCode path parameter. Countries with valid sales-tax jurisdictions are Canada and the US. The response from this call tells you the jurisdictions for which a seller can configure tax tables. Required: country_code.
- **e_bay_sales_taxes_bulk_upsert** — This method creates or updates multiple sales-tax table entries. Sales-tax tables can be set up for countries that support different tax jurisdictions.
- **get_single_e_bay_sales_tax_by_id** — This call retrieves the current sales-tax table entry for a specific tax jurisdiction. Specify the jurisdiction to retrieve using the countryCode and jurisdictionId path parameters. All four response fields will be returned if a sales-tax entry exists for the tax jurisdiction. Required: id, country_code.
- **update_a_e_bay_sales_tax_by_id** — This method creates or updates a sales-tax table entry for a jurisdiction. Specify the tax table entry you want to configure using the two path parameters: countryCode and jurisdictionId. Required: id, country_code.
- **delete_a_e_bay_sales_tax_by_id** — This call deletes a sales-tax table entry for a jurisdiction. Specify the jurisdiction to delete using the countryCode and jurisdictionId path parameters. Required: id, country_code.
- **list_all_e_bay_sales_taxes** — Use this call to retrieve all sales tax table entries that the seller has defined for a specific country. All four response fields will be returned for each tax jurisdiction that matches the search criteria. Required: country_code.
- **list_all_e_bay_schedule_result_files** — This method downloads the latest Order Report generated by the schedule. The response of this call is a compressed or uncompressed CSV, XML, or JSON file, with the applicable file extension. Specify the schedule_id path parameter to download its last generated file. Required: schedule_id. Returns a file (binary or tab-separated), not JSON.
- **get_single_e_bay_schedule_template_by_id** — This method retrieves the details of the specified template. Specify the template to retrieve using the schedule_template_id path parameter. Use the getScheduleTemplates method to find a schedule template if you do not know the schedule_template_id. Required: id.
- **list_all_e_bay_schedule_templates** — This method retrieves an array containing the details and status of all schedule templates based on the specified feed_type. Use this method to find a schedule template if you do not know the schedule_template_id. Required: feed_type. The connector follows eBay's next link through every page.
- **list_all_e_bay_schedules** — This method retrieves an array containing the details and status of all schedules based on the specified feed_type. Use this method to find a schedule if you do not know the schedule_id. Required: feed_type. The connector follows eBay's next link through every page.
- **create_a_e_bay_schedule** — This method creates a schedule, which is a subscription to the specified schedule template. Returns {}: the new id is the last part of the location response header (or use schedules list).
- **get_single_e_bay_schedule_by_id** — This method retrieves schedule details and status of the specified schedule. Specify the schedule to retrieve using the schedule_id. Use the getSchedules method to find a schedule if you do not know the schedule_id. Required: id.
- **update_a_e_bay_schedule_by_id** — This method updates an existing schedule. Specify the schedule to update using the schedule_id path parameter. If the schedule template has changed after the schedule was created or updated, the input will be validated using the changed template. Required: id.
- **delete_a_e_bay_schedule_by_id** — This method deletes an existing schedule. Specify the schedule to delete using the schedule_id path parameter. Required: id.
- **list_all_e_bay_seller_funds_summaries** — Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including all Finances API methods. Required: ebay_marketplace_id.
- **list_all_e_bay_seller_standards_profiles** — This call retrieves all the standards profiles for the associated seller. A standards profile is a set of eBay seller metrics and the seller's associated compliance values (either TOP_RATED, ABOVE_STANDARD, or BELOW_STANDARD).
- **get_single_e_bay_seller_standards_profile_by_id** — This call retrieves a single standards profile for the associated seller. A standards profile is a set of eBay seller metrics and the seller's associated compliance values (either TOP_RATED, ABOVE_STANDARD, or BELOW_STANDARD). Required: id, program.
- **list_all_e_bay_seller_subscriptions** — This method retrieves a list of subscriptions associated with the seller account. The connector follows eBay's next link through every page.
- **list_all_e_bay_shipping_carriers** — This method retrieves a list of supported shipping carriers for the specified marketplace. It provides essential information for sellers to understand which shipping carriers are available for use when listing items on that eBay marketplace. Required: marketplace_id.
- **list_all_e_bay_shipping_fulfillments** — Use this call to retrieve the contents of all fulfillments currently defined for a specified order based on the order's unique identifier, orderId. This value is returned in the getOrders call's members orderId field when you search for orders by creation date or shipment status. Required: order_id.
- **create_a_e_bay_shipping_fulfillment** — When you group an order's line items into one or more packages, each package requires a corresponding plan for handling, addressing, and shipping; this is a shipping fulf. Required: order_id. Returns {}: the new id is the last part of the location response header (or use shipping_fulfillments list).
- **get_single_e_bay_shipping_fulfillment_by_id** — Use this call to retrieve the contents of a fulfillment based on its unique identifier, fulfillmentId (combined with the associated order's orderId). Required: id, order_id.
- **list_all_e_bay_shipping_locations** — This method retrieves a list of supported shipping locations for the specified marketplace. It provides sellers with information on where they can ship their items. Sellers can use this information to configure their shipping settings. Required: marketplace_id.
- **list_all_e_bay_shipping_services** — This method retrieves a list of shipping services supported for the specified marketplace, including valid shipping services, shipping times, and package constraints such as size and weight. Manage shipping services using business policies through the fulfillment_policy resource of the Account v1 API. Required: marketplace_id.
- **list_all_e_bay_site_visibility_policies** — This method returns eBay international site visibility policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. Required: marketplace_id.
- **list_all_e_bay_sku_location_mappings** — This method allows sellers to retrieve the locations mapped to a specific SKU within a listing. The listingId and sku of the listing are passed in as path parameters. Required: listing_id, sku.
- **e_bay_sku_location_mappings_bulk_update** — This method allows sellers to map multiple fulfillment center locations to single-SKU listing, or to a single SKU within a multiple-variation listing. This allows eBay to leverage the location metadata associated with a seller’s fulfillment centers to calculate more accurate estimated delivery dates on their listing. Required: listing_id, sku.
- **e_bay_sku_location_mappings_bulk_delete** — This method allows sellers to remove all location mappings associated with a specific SKU within a listing. The listingId and sku of the listing are passed in as path parameters. Important!. Required: listing_id, sku.
- **list_all_e_bay_store_categories** — This method is used to retrieve the category hierarchy for an eBay user's store.
- **create_a_e_bay_store_category** — This method is used to add a single new custom category to a user's eBay store through an asynchronous request. A successful call returns the getStoreTask URI in the Location response header. Call getStoreTask (or getStoreTasks) method to retrieve the status of the add category operation. Important!.
- **update_a_e_bay_store_category_by_id** — This method is used to rename the single category of a user's eBay store through an asynchronous request. A successful call returns the getStoreTask URI in the Location response header. The user calls getStoreTask to retrieve the status of the rename category operation. Important!. Required: id.
- **delete_a_e_bay_store_category_by_id** — This method is used to delete one custom category of a user's eBay store through an asynchronous request. A successful call returns the getStoreTask URI in the Location response header. Call getStoreTask (or getStoreTasks) method to retrieve the status of the delete category operation. Important!. Required: id.
- **create_a_e_bay_store_category_move** — This method is used to move an existing user's eBay store custom category through an asynchronous request. A successful call returns the getStoreTask URI in the Location response header. The user calls getStoreTask to retrieve the status of the move category operation. Important!.
- **get_single_e_bay_store_task_by_id** — This method retrieves the current status of a recent store operation. The unique identifier of the task is passed in as a path parameter. Required: id.
- **list_all_e_bay_store_tasks** — This method retrieves the status of all async store tasks for a store. Every task is set as FAILED or COMPLETED once it's execution time reaches 24 hours.
- **list_all_e_bay_stores** — This method is used to retrieve information for an eBay user's store such as store name, store URL, and description.
- **create_a_e_bay_task_file** — This method associates the specified file with the specified task ID and uploads the input file. After the file has been uploaded, the processing of the file begins. Reports often take time to generate and it's common for this method to return an HTTP status of 202, which indicates the report is being generated. Required: task_id.
- **list_all_e_bay_task_input_files** — This method downloads the file previously uploaded using uploadFile. Specify the task_id from the uploadFile call. Required: task_id. Returns a file (binary or tab-separated), not JSON.
- **list_all_e_bay_task_result_files** — This method retrieves the generated file that is associated with the specified task ID. The response of this call is a compressed or uncompressed CSV, XML, or JSON file, with the applicable file extension. For details about how this method is used, see Working with Order Feeds in the Selling Integration Guide. Required: task_id. Returns a file (binary or tab-separated), not JSON.
- **list_all_e_bay_tasks** — This method returns the details and status for an array of tasks based on a specified feed_type or schedule_id. Specifying both feed_type and schedule_id results in an error. Since schedules are based on feed types, you can specify a schedule ( schedule_id) that returns the needed feed_type. eBay requires feed_type or schedule_id. The connector follows eBay's next link through every page.
- **create_a_e_bay_task** — This method creates an upload task or a download task without filter criteria. When using this method, specify the feedType and the feed file schemaVersion. The feed type specified sets the task as a download or an upload task. Required: ebay_marketplace_id.
- **get_single_e_bay_task_by_id** — This method retrieves the details and status of the specified task. The input is task_id. For details of how this method is used, see Working with Order Feeds in the Selling Integration Guide. Required: id.
- **list_all_e_bay_traffic_reports** — This method returns a report that details the user traffic received by a seller's listings. A traffic report gives sellers the ability to review how often their listings appeared on eBay, how many times their listings are viewed, and how many purchases were made.
- **list_all_e_bay_transaction_summaries** — Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including all Finances API methods. Required: ebay_marketplace_id, filter. The filter must include transactionStatus.
- **list_all_e_bay_transactions** — Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including all Finances API methods. Required: ebay_marketplace_id. The connector follows eBay's next link through every page.
- **get_single_e_bay_transfer_by_id** — Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including all Finances API methods. Required: id, ebay_marketplace_id.
- **list_all_e_bay_users** — This method retrieves the account profile information for an authenticated user, which requires a User access token. What is returned is controlled by the scopes. For a business account you use the default scope commerce identity readonly, which returns all the fields in the businessAccount container.
- **create_a_e_bay_video_upload** — This method associates the specified file with the specified video ID and uploads the input file. After the file has been uploaded the processing of the file begins. The size of the video to be uploaded must exactly match the size of the video's input stream that was set in the createVideo method. Required: video_id.
- **create_a_e_bay_video** — This method creates a video resource. When using this method, specify the title, size, and classification of the video resource to be created. Returns {}: the new id is the last part of the location response header.
- **get_single_e_bay_video_by_id** — This method retrieves a video's metadata and content given a specified video ID. The method returns the title, size, classification, description, video ID, playList, status, status message (if any), expiration date, and thumbnail image of the retrieved video. Required: id.

## How it works

1. **Link your customer's eBay account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach eBay.** The Proxy API is a 1-to-1 mapping of the eBay API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Launch a multichannel listing and inventory sync** — Offer sellers a single catalog that pushes products to eBay as inventory items and offers, then keeps stock and pricing in sync in real time. Truto handles eBay's two-step inventory/offer model so you can ship listing workflows without reverse-engineering the API.
- **Automate order routing and fulfillment** — Pull new eBay orders into your OMS or WMS, route them to the right warehouse or 3PL, and push tracking numbers back to eBay to meet shipping SLAs. Ideal for operations platforms that need reliable order ingestion and fulfillment write-back.
- **Reconcile eBay payouts in accounting software** — Give finance teams a clean breakdown of eBay sales, fees, ad spend, and tax withholdings so bank deposits match the books. Perfect for accounting automation SaaS feeding QuickBooks, Xero, or NetSuite.
- **Centralize buyer messaging and dispute handling** — Pull eBay conversations, returns, and payment disputes into a unified helpdesk so agents can respond without leaving your product. Keeps sellers within eBay's response-time requirements while improving CSAT.
- **Programmatically manage Promoted Listings campaigns** — Enable AdTech and repricing platforms to adjust campaign budgets, bidding strategies, keywords, and ad bids based on margin and inventory data. Lets sellers run algorithmic advertising across their eBay catalog.

## What you can build

- **Two-way inventory and price sync** — Bulk upsert inventory items and push price/quantity updates to eBay whenever stock changes in your system, with location-aware mapping.
- **Listing lifecycle manager** — Create inventory items, build offers, publish and unpublish listings, and migrate legacy listings — all from a single workflow in your UI.
- **Order ingestion with tracking write-back** — Poll new and updated eBay orders, enrich them with buyer and line-item context, and create shipping fulfillments with carrier and tracking data.
- **Payout and earnings reconciliation** — Fetch payouts, order earnings, transaction summaries, and seller funds data to generate journal entries that match eBay's net deposits.
- **Promoted Listings control panel** — Let sellers create and clone campaigns, manage ad groups, update keywords and negative keywords, and bulk-adjust bids and budgets.
- **Unified buyer messaging and disputes inbox** — Surface eBay conversations and payment disputes as tickets, reply with messages, and submit evidence or contests directly through your app.

## FAQs

### How does authentication work for connecting an eBay seller account?

eBay uses OAuth 2.0 with user consent and scoped permissions. Truto handles the full OAuth flow, token storage, and refresh so your end users just click Connect and authorize the scopes your integration requires.

### Does Truto support eBay's two-step inventory item and offer model?

Yes. You can bulk upsert inventory items, create and publish offers, manage inventory item groups, and migrate legacy listings using the dedicated tools for each stage of the listing lifecycle.

### Can we sync orders and push tracking numbers back to eBay?

Yes. You can list orders with filtering, fetch a single order by ID, and create shipping fulfillments to send carrier and tracking information back to eBay so listings are marked shipped.

### How do we handle eBay's rate limits and bulk operations?

eBay enforces per-call daily and per-minute limits that vary by API family. Truto exposes bulk endpoints (inventory, offers, ads, keywords, price/quantity) wherever eBay supports them, which is the recommended way to stay within limits for high-volume sellers.

### Can we retrieve payout and fee data for accounting reconciliation?

Yes. You can list payouts, payout summaries, order earnings, order earnings summaries, transaction summaries, transactions, and seller funds summaries to break down net deposits into sales, fees, ads, and taxes.

### Does the integration cover Promoted Listings and advertising workflows?

Yes. You can manage campaigns, ad groups, ads, keywords, negative keywords, budgets, bidding strategies, and bid suggestions, plus pull traffic and promotion reports for advertising analytics.

### Can we subscribe to eBay webhooks for real-time updates?

Yes. eBay supports notification topics and subscriptions, and Truto exposes tools to create destinations, manage subscription filters, and enable or disable subscriptions so you can react to events without polling.

## Related reading

- [Connect eBay to ChatGPT: Manage Ad Campaigns & Ad Group Bids](https://truto.one/blog/connect-ebay-to-chatgpt-manage-ad-campaigns-ad-group-bids/) — Learn how to connect eBay to ChatGPT using a managed MCP server to automate Promoted Listings, adjust ad group bids, and orchestrate campaign workflows.
- [Connect eBay to Claude: Sync Orders, Messages & Refund Requests](https://truto.one/blog/connect-ebay-to-claude-sync-orders-messages-refund-requests/) — Learn how to connect eBay to Claude using a managed MCP server. This guide covers tool configuration, e-commerce workflows, and API rate limits.
- [Connect eBay to AI Agents: Scale Inventory, Offers & Store Tasks](https://truto.one/blog/connect-ebay-to-ai-agents-scale-inventory-offers-store-tasks/) — Learn how to connect eBay to AI Agents using Truto's SDK. Fetch AI-ready tools to autonomously scale inventory, manage orders, and run store operations.
