Policies & Locations

Seller Programs

Before you can create policies, your account must be enrolled in SELLING_POLICY_MANAGEMENT.

POST /api/v1/policies/sellerPrograms
{
  "policy": {
    "programType": "SELLING_POLICY_MANAGEMENT"
  }
}

Fulfillment Policies

Defines shipping methods, handling time, and service options. Required when publishing any offer.

Payment Policies

Returns Policies

Policies are per marketplace. A fulfillment policy created for EBAY_US cannot be used when publishing an offer on EBAY_GB. Create a separate set of policies for each marketplace you operate in.

Locations

Locations define where inventory is stored and shipped from. At least one location is required to publish any offer.

The merchantLocationKey you assign at creation becomes the location's permanent ID. Choose a descriptive, unique value (e.g., WAREHOUSE-US-01).

Minimal create payload:

POST /api/v2/locations
{
  "location": {
    "merchantLocationKey": "WAREHOUSE-US-01",
    "location": {
      "address": {
        "addressLine1": "123 Main St",
        "city": "Los Angeles",
        "stateOrProvince": "CA",
        "postalCode": "90001",
        "country": "US"
      }
    },
    "locationTypes": ["WAREHOUSE"],
    "name": "Main Warehouse"
  }
}

Categories

Use categories to assign the correct eBay category when creating products or offers. The marketplaceId parameter is required for all category endpoints.

Category Aspects (Item Specifics)

Aspects are the required or recommended item specifics for each category (e.g., Brand, Color, Material). Some aspects are mandatory — products without required aspects may fail to publish.

Filter to only required aspects:

GET /api/v2/categories/{categoryId}/aspects?marketplaceId=EBAY_US&required=true