Skip to main content

Fields may be optional or conditionally required for a specific create call, but become required when calling the publishOffer, bulkPublishOffer, or publishOfferByInventoryItemGroup method to create active listings. For example, a missing merchantLocationKey will not cause issues when first creating an offer (the createOffer is successful), but calling the publishOffer method will fail if the offer does not have the merchantLocationKey. These are noted in each method's reference documentation as a Publish offer note.

Important! In order to use the Inventory API, sellers need to opt in to business policies (see optInToProgram). Once opted in, use the Account API v1 to set up policies for fulfillment (previously known as shipping), return, and payment. All three policies are required to publish offers and create active listings through the Inventory API. Sellers reference these business policies by their unique identifiers. See the use cases in the Account API v1 Overview for more information.


Note: Publishing an offer that can be picked-up in a store (Available for In-Store Pickup) has additional requirements. See In-store pickup for specifics.

The following fields, organized by resource objects, are required before a live offer can be published to an eBay marketplace.

Location fields

The following location fields are required to publish an offer:

Note: Use the createInventoryLocation method to create the required location fields. This method will not work without the above listed fields.

Inventory item fields

The following inventory item fields are required to publish an offer:

Note: Use the createOrReplaceInventoryItem / bulkCreateOrReplaceInventoryItem method to set the required inventory item fields.

Inventory item group fields

The following inventory item group fields are required to publish a multiple-SKU offer:

Note: Use the createOrReplaceInventoryItemGroup method to set the required inventory item group fields.

Offer fields

The following offer fields are required to publish an offer:

Note: Use the createOffer / bulkCreateOffer method to set the required offer fields.