# Instacart

Instacart Developer Platform APIs to create shoppable lists/recipes and discover nearby retailers

- **Category:** ecommerce
- **Auth:** NO_AUTH
- **Composio Managed App Available?** N/A
- **Tools:** 4
- **Triggers:** 0
- **Slug:** `INSTACART`
- **Version:** 20260227_00

## Tools

### Create Instacart Recipe Link

**Slug:** `INSTACART_CREATE_INSTACART_RECIPE_LINK`

Create 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Recipe title (e.g., 'Vanilla Yogurt Parfait'). This will be displayed to users when they access the Instacart link. |
| `question` | string | Yes | 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. |
| `ingredients` | array | Yes | 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. |
| `instructions` | array | Yes | 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_name` | string | No | Partner identifier. This value should always be 'OpenAI'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Recipe Page

**Slug:** `INSTACART_CREATE_RECIPE_PAGE`

Create 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Recipe title displayed on the page (e.g., 'Classic Spaghetti Carbonara') |
| `author` | string | No | Recipe creator/author name for attribution. |
| `servings` | integer | No | Number of servings the recipe makes. |
| `image_url` | string | No | URL to recipe image (recommended 500x500px). Displayed at top of recipe page. |
| `expires_in` | integer | No | Days until the recipe link expires (1-365). Defaults to 30 days if not specified. |
| `ingredients` | array | Yes | List of recipe ingredients. Each ingredient needs at minimum a 'name' field with the generic product name. |
| `cooking_time` | integer | No | Total cooking/preparation time in minutes. |
| `instructions` | array | No | Ordered list of preparation steps (e.g., ['Preheat oven to 350F', 'Mix ingredients', 'Bake for 30 minutes']). |
| `landing_page_configuration` | object | No | Configuration options for the generated recipe landing page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Shopping List Page

**Slug:** `INSTACART_CREATE_SHOPPING_LIST_PAGE`

Create 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Title displayed at the top of the shopping list page (e.g., 'Weekly Groceries', 'Party Supplies') |
| `image_url` | string | No | URL of an image (ideally 500x500 pixels) to display on the shopping list page. Must be a publicly accessible HTTPS URL. |
| `expires_in` | integer | No | Number of days until the shopping list link expires. Valid range: 1-365. Default is 30 days if not specified. |
| `line_items` | array | Yes | List of items to include on the shopping list. Each item must have at least a name. |
| `instructions` | string | No | Additional context or instructions to display on the page (e.g., recipe steps, dietary notes, shopping tips). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Nearby Retailers

**Slug:** `INSTACART_GET_NEARBY_RETAILERS`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `postal_code` | string | Yes | 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'). |
| `country_code` | string | Yes | Two-letter ISO country code. Currently supports 'US' (United States) and 'CA' (Canada). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |