Instacart Developer Platform APIs to create shoppable lists/recipes and discover nearby retailers
Instacart Developer Platform APIs to create shoppable lists/recipes and discover nearby retailers On Nagent, Instacart is exposed as a fully-configurable ecommerce integration that any agent can call — 4 actions, and no authentication authentication. No code is required to wire Instacart into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Instacart to automate the kinds of tasks ecommerce teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Instacart into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Instacart, with input parameters and output schema. Drop these into any step of an agent built in Helix.
INSTACART_CREATE_INSTACART_RECIPE_LINKCreate an Instacart link to the shopping list of ingredients for a recipe. This action generates a shareable Instacart URL that allows users to purchase all recipe ingredients with one click. Use this when you have a recipe with ingredients and want to enable easy grocery shopping through Instacart.
Input parameters
Recipe title (e.g., 'Vanilla Yogurt Parfait'). This will be displayed to users when they access the Instacart link.
The question asked by the user about the recipe in the current chat session (e.g., 'recipe for vanilla yogurt parfait'). This field stores the original user query.
List of recipe ingredients where each element is a string describing the ingredient (e.g., '2 cups of greek yogurt', '2 tablespoons of honey'). Do not include items the user already mentioned they have.
Ordered list of recipe instructions where each element is a preparation step (e.g., 'Mix greek yogurt with honey and vanilla extract in a bowl').
Partner identifier. This value should always be 'OpenAI'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
INSTACART_CREATE_RECIPE_PAGECreate a shareable recipe page on Instacart and return the URL. This action generates an Instacart recipe page where users can: - View the recipe with ingredients, instructions, and image - Add all recipe ingredients to their cart with one click - Select their preferred nearby store for shopping Use this for meal planning apps, recipe blogs, cooking assistants, or any application that wants to enable easy grocery shopping from recipes. The returned URL can be shared via email, SMS, or social media.
Input parameters
Recipe title displayed on the page (e.g., 'Classic Spaghetti Carbonara')
Recipe creator/author name for attribution.
Number of servings the recipe makes.
URL to recipe image (recommended 500x500px). Displayed at top of recipe page.
Days until the recipe link expires (1-365). Defaults to 30 days if not specified.
List of recipe ingredients. Each ingredient needs at minimum a 'name' field with the generic product name.
Total cooking/preparation time in minutes.
Ordered list of preparation steps (e.g., \['Preheat oven to 350F', 'Mix ingredients', 'Bake for 30 minutes'\]).
Configuration options for the generated recipe landing page.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
INSTACART_CREATE_SHOPPING_LIST_PAGECreate a shareable Shopping List Page on Instacart. This action generates a public Instacart URL where users can view a list of products, select their preferred store, and add items to their cart for delivery or pickup. The generated link can be shared via email, messaging apps, or embedded in websites. Use cases: - Share grocery lists with family members - Create shopping lists for recipes or meal plans - Enable one-click shopping for recommended products
Input parameters
Title displayed at the top of the shopping list page (e.g., 'Weekly Groceries', 'Party Supplies')
URL of an image (ideally 500x500 pixels) to display on the shopping list page. Must be a publicly accessible HTTPS URL.
Number of days until the shopping list link expires. Valid range: 1-365. Default is 30 days if not specified.
List of items to include on the shopping list. Each item must have at least a name.
Additional context or instructions to display on the page (e.g., recipe steps, dietary notes, shopping tips).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
INSTACART_GET_NEARBY_RETAILERSRetrieves a list of grocery retailers available for delivery or pickup in a given postal code area. Use this action to discover which retailers (e.g., Safeway, Walmart, Publix) are available before creating shopping lists or recipe pages. The returned retailer_key values can be used with other Instacart actions like create_shopping_list_page or create_recipe_page. Supports United States (US) and Canada (CA) postal codes.
Input parameters
Postal code to search for nearby retailers. Use 5-digit ZIP codes for US (e.g., '94103') or alphanumeric postal codes for Canada (e.g., 'M5V 3L9').
Two-letter ISO country code. Currently supports 'US' (United States) and 'CA' (Canada).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 89 agents privately built on Nagent that already use Instacart.
Build on Nagent
Connect Instacart to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Instacart, and click "Connect Now." You'll authenticate with no authentication (it’s public) — Nagent handles credential storage and refresh automatically. Once connected, Instacart is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Instacart is connected, you configure its 4 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Instacart steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Instacart event fires, the agent kicks off automatically.
Every Instacart action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Instacart ships with 4 pre-built ecommerce actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Instacart together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Instacart-based workflows tailored to your business.