Skip to main content

​
Fulfillment API Overview

The Fulfillment API provides 50+ tools to manage the entire order fulfillment process, from order retrieval to shipping label generation and tracking updates.

Order Management

Retrieve and process customer orders

Shipping Labels

Generate and print shipping labels

Tracking Updates

Upload tracking numbers and shipment info

Cancellations & Returns

Handle order cancellations and returns

​
Order Fulfillment Workflow

1

Retrieve Orders

Get new orders from eBay
const orders = await mcp.useTool('fulfillment_getOrders', {
  filter: 'orderfulfillmentstatus:{NOT_STARTED}'
});
2

Process Payment

Verify payment received (handled by eBay Managed Payments)
3

Ship Items

Pack and ship the order
await mcp.useTool('fulfillment_createShippingFulfillment', {
  order_id: 'order_id_here',
  tracking_number: '1Z999AA10123456784',
  shipping_carrier_code: 'UPS'
});
4

Mark as Shipped

Upload tracking information

​
Common Use Cases

​
Daily Order Processing

async function processOrders() {
  // Get unfulfilled orders
  const { orders } = await mcp.useTool('fulfillment_getOrders', {
    filter: 'orderfulfillmentstatus:{NOT_STARTED}',
    limit: 50
  });

  for (const order of orders) {
    console.log(`Processing order: ${order.orderId}`);
    console.log(`Buyer: ${order.buyer.username}`);
    console.log(`Total: ${order.pricingSummary.total.value} ${order.pricingSummary.total.currency}`);

    // Get items to ship
    order.lineItems.forEach(item => {
      console.log(`  - ${item.title} (SKU: ${item.sku}) x${item.quantity}`);
    });
  }
}

await processOrders();

​
Next Steps

Order Management

Detailed order management guide

Shipping & Tracking

Ship orders and upload tracking

Managing Orders Guide

Complete order fulfillment tutorial

API Reference

All API tools

​
Resources