Skip to main content

Instacart Connect Fulfillment API

Offer your customers the convenience of Instacart scheduling, full-service shopping, delivery, pickup, and last mile delivery with the Instacart Connect Fulfillment API.

The Fulfillment API brings together the best of a Grocery API, Delivery API, and Pickup API. You can offer full-service shopping, where shoppers use the Instacart Shopper app while picking and suggest replacements from your catalog. You can offer same-day or scheduled delivery and pickup options with or without the full-service shopping experience. And when an order transitions to a new status in the order flow, you can notify customers to keep them up to date. With the Fulfillment API, you implement the set of capabilities you want within a unified API platform experience.

After you implement the Fulfillment API into your ecommerce site, your customers shop your site for groceries or other items as usual. They select a fulfillment option from among the options you choose to offer, and they select a time slot for when they'd like to receive their order. If a customer chooses a delivery option, an Instacart shopper delivers the purchased items to the customer.

note

While Instacart focuses on solutions for grocery retailers and their customers, any retailer can benefit by using the Fulfillment API and the Instacart shopper network to fulfill their customer orders.

Fulfillment options

You can choose to offer any of the following options:

OptionDescriptionUse cases
DeliveryInstacart delivers the order. A shopper uses the Instacart Shopper app while picking the ordered items for the customer. The customer receives order status notifications and shopper communications.Full-service delivery, Delivery only
PickupThe customer wants to pick up the order. A shopper uses the Instacart Shopper app while picking the ordered items for the customer. The customer receives order status notifications and shopper communications.Full-service pickup, Partner-pick pickup
Last mile deliveryA retailer employee picks the order without using the Instacart Shopper app. When the order is ready, the retailer stages the order for an Instacart driver to pick up and deliver.Delivery only (without the Instacart Shopper app)

Instacart API

Instacart APIs are RESTful. They use predictable, resource-oriented URLs and HTTP response codes. The APIs use built-in HTTP features, such as HTTP authentication and HTTP verbs, which are understood by HTTP clients.

Backward compatibility

As the Instacart Connect product evolves and improves, we might make changes to the APIs to take advantage of new capabilities and improvements. All changes made to APIs maintain backwards compatibility. Any new fields are optional and can be ignored if you want the APIs to continue to function as is.

Before you begin

To integrate Instacart Connect APIs with your ecommerce site, you need the following items:

  • A signed agreement with Instacart
  • The URLs for your assigned Instacart Connect development and production servers
  • Your Instacart Connect client ID and secret
  • The storefront that you use to develop new components and flows

If you are missing any of the Instacart items, contact your Instacart Connect representative.

Using the Fulfillment API

Use the following guides to help you get started with the Connect Fulfillment API:

We are enhancing the Fulfillment Guide with concepts, tutorials, and how-to guides. If you don’t see a feature or use case described there, check the Fulfillment API documentation or contact your Instacart Connect representative to discuss your requirements.