Changelog

This changelog summarizes the updates and enhancements made to the Instacart Developer Platform. The most recent changes are listed first. All changes are non-breaking changes.

September 18, 2025

• Added support for upcs. When product UPCs are present in line items, Instacart searches exclusively using the provided identifiers, with retailers carrying matching products receiving higher priority in selection. For more information, see Create a shopping list page and Create a recipe pages APIs.

September 18, 2025

• Added Model Context Protocol (MCP) tutorial. This tutorial shows how to use MCP to enable your AI agent to create recipe pages and shopping lists on Instacart Marketplace without needing to build direct API integrations. For more information, see Connect your AI agent to Instacart with MCP.

September 15, 2025

• Added partner messaging, covering external messaging, trademark usage, and content requirements for developer partners integrating with the Instacart Developer Platform. For more information, see Partner messaging guidelines.

August 6, 2025

• Added additional concepts to consider when working with the Create a recipe page API, including:
  • Update an ingredient's display text.
  • Work with measurements.

July 21, 2025

• Added additional concepts to consider when working with the Create a recipe page API, including:
  • Update an ingredient's display text.
  • Work with measurements.

May 27, 2025

• Added URL structure section to help retailers better visualize how to structure their recipe page URLs. For more information, see creating a recipe page.

May 19, 2025

• Added details explaining the difference between creating a shopping list page LineItem with a single measurement and one with multiple measurements. For more information, see Create a shopping list page.

April 17, 2025

• Added Get Nearby retailers API.
• Added option to set preferred retailer when creating a recipe page.

March 31, 2025

• Removed optional Tastemakers account creation option from the Pre-launch checklist page.
• Added Impact.com email notification to the Approval process page.

March 3, 2025

• Added API key rotation instructions to the API keys page.

January 29, 2025

• Added instructions for Impact to the Conversion tracking and affiliate payments. page.
• Added additional CTA button text options to the CTA design page.

January 14, 2025

• Renamed the Specify preferred brands page to Filters.
• Added health_filters to the Filters page.
• Added health_filters example to the Filters sample request.

December 4, 2024

• Added the following pages to the Design section:
  • Design overview
  • CTA design
  • CTA placement
  • Instacart logos

December 2, 2024

• Removed the country_code field from the Create recipe page.

November 15, 2024

• Updated the Create recipe page and the Create shopping list page to include a new optional request parameter country_code, which represents the country the landing page will be on and the url domain. Possible values are 'CA' and 'US'. Defaults to 'US'.

November 7, 2024

• Updated the Conversion tracking and affiliate payments methods from Instacart Tastemakers to Impact Radius.

October 23, 2024

• Created the Developer guidelines page.

August 22, 2024

• Updated the Create recipe page and the Create shopping list page to include a new request parameter expires_in, which represents the number of days until the recipe or shopping list expires. If the recipe or shopping list is not shopped or save by then, the recipe will be deleted. If partners do not pass a value for expires_in by September 30, 2024, we will set default expiry of 30 days.

August 2, 2024

• Created the Test your recipes tutorial.
• Created the Troubleshooting page.

July 22, 2024

• Launched a self-service dashboard for Instacart Developer Platform. After you are invited to the platform, you can use the dashboard to manage API keys, set up your team, and get access to documentation.

  

• Added or updated the following topics in the documentation:

  • Get started
  • Conversion tracking and affiliate payments
  • Pre-launch checklist
  • Instacart approval process
  • Instacart developer terms

June 10, 2024

• Updated the title of the Create shopping link topic to Create shopping list page. The endpoint itself remains unchanged.

May 21, 2024

• Created the FAQ page.

May 7, 2024

• Added the Create recipe page endpoint. This endpoint has more recipe-specific attributes, such as the author and the content creator credit line. Please update your shoppable recipes to call the new endpoint and take advantage of the expanded list of attributes. You can continue to use the existing Create shopping link endpoint for shopping lists.
  note

  To avoid a breaking change, the Create shopping link endpoint continues to support recipes, but it won’t be updated with the new recipe attributes.

May 1, 2024

• Created the Specify preferred brands how-to guide.

April 19, 2024

• Created the Units of measurement page.

April 15, 2024

• Added an optional line_item_measurements object to the Create shopping link endpoint.

• Added an optional display_text field to the LineItem object in the Create shopping link endpoint.

April 5, 2024

• Updated the information on integer and string data formats in the Data format topic.

March 27, 2024

• Launched Instacart Developer Platform for public use.

March 25, 2024

• Added an optional Filter object to the Create shopping link endpoint.

March 14, 2024

• Removed the enable_saving and enable_sharing attributes from the LandingPageConfiguration object in the Create shopping link endpoint. These attributes are now set to false by default. To enable these attributes, contact your Instacart representative.

March 5, 2024

• Added a Create a recipe page tutorial.

February 15, 2024

• Published the early access documentation site.