NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Instacart connects to a Nagent workspace with no credentials. Once it is connected, agents can call 4 Instacart actions, such as "Create Instacart Recipe Link", "Create Recipe Page" and "Create Shopping List Page". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Instacart, with input parameters and output schema.
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
Agents can call 4 Instacart actions on Nagent, including "Create Instacart Recipe Link", "Create Recipe Page" and "Create Shopping List Page". Create Instacart Recipe Link: Create an Instacart link to the shopping list of ingredients for a recipe. Each action is listed on this page with its input parameters and its output.
Instacart connects with no credentials, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Instacart Recipe Link takes 4 required inputs: title, question, ingredients and instructions. It also takes 1 optional input: partner_name. It returns data, error and successful.