> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Adobe Commerce (Magento)

The Adobe Commerce (Magento) connector lets your AI agent act in each user's Adobe Commerce (Magento) account. Each user connects their own Adobe Commerce (Magento) access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 29 tools.

**Authentication:** Bearer Token
**Categories:** Marketing, CRM & Sales
**Tools:** 29: 14 read, 12 write, 3 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ADOBECOMMERCE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Adobe Commerce (Magento) connection

   In **AgentKit > Connections**, create an Adobe Commerce (Magento) connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'adobecommerce'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Adobe Commerce (Magento):', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'adobecommerce_categories_tree_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "adobecommerce"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Adobe Commerce (Magento):", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="adobecommerce_categories_tree_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Adobe Commerce (Magento) credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'adobecommerce_categories_tree_get',
  toolInput: {},
  connector: 'adobecommerce',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="adobecommerce_categories_tree_get",
    tool_input={},
    connection_name="adobecommerce",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `adobecommerce_categories_tree_get`

Get Category Tree · Read-only

Get the category tree from a root category down to a depth.
Returns the root category with id, name, is_active, position, level, product_count and nested children_data.
Use adobecommerce_categories_tree_get to browse categories and find IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `depth` (`integer`, optional): How many levels to return. Example: 3
- `root_category_id` (`integer`, optional): Category to start from; defaults to the store's root. Example: 2

Example input: `{}`

### `adobecommerce_category_products_list`

List Category Products · Read-only

List the products assigned to a category.
Returns an array of links with sku, position and category_id.
Use adobecommerce_category_products_list to see a category's products. Use adobecommerce_category_product_assign to add one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `category_id` (`integer`, required): Category ID. Example: 4

Example input: `{"category_id":4}`

### `adobecommerce_customer_get`

Get Customer · Read-only

Get one customer by ID.
Returns id, email, firstname, lastname, group_id, website_id, store_id, addresses, default_billing and default_shipping.
Use adobecommerce_customer_get when you know the ID. Use adobecommerce_customers_search to find it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, required): Customer ID. Example: 7

Example input: `{"customer_id":7}`

### `adobecommerce_customers_search`

Search Customers · Read-only

Search customers with one filter (for example email, firstname or group_id), sorting and paging.
Returns items[], search_criteria and total_count. Each customer has id, email, firstname, lastname, group_id, website_id, addresses and created_at.
Use adobecommerce_customers_search to find a customer. Use adobecommerce_customer_get for one customer by ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `condition_type` (`string`, optional): Comparison: eq (default), neq, like, nlike, in, nin, gt, lt, gteq, lteq, from, to, null, notnull or finset. Example: like. One of: `eq`, `neq`, `like`, `nlike`, `in`, `nin`, `gt`, `lt`, `gteq`, `lteq`, `from`, `to`, `null`, `notnull`, `finset`.
- `current_page` (`integer`, optional): Page number, starting at 1. Example: 1. Default: `1`.
- `filter_field` (`string`, optional): Field to filter on. Example: email
- `filter_value` (`string`, optional): Value to compare; with condition_type like, use % as a wildcard; with in, a comma-separated list. Example: jane@example.com
- `page_size` (`integer`, optional): Results per page. Keep it small: without it Commerce returns every match. Example: 20. Default: `20`.
- `sort_direction` (`string`, optional): ASC or DESC. Example: DESC. One of: `ASC`, `DESC`.
- `sort_field` (`string`, optional): Field to sort by. Example: created_at

Example input: `{}`

### `adobecommerce_inventory_source_items_list`

Search Inventory Source Items · Read-only

Search per-source inventory records (Multi-Source Inventory) with one filter, sorting and paging.
Returns items[], search_criteria and total_count. Each item has sku, source_code, quantity and status.
Use adobecommerce_inventory_source_items_list to see stock by warehouse. Use adobecommerce_inventory_source_items_update to change it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `condition_type` (`string`, optional): Comparison: eq (default), neq, like, nlike, in, nin, gt, lt, gteq, lteq, from, to, null, notnull or finset. Example: like. One of: `eq`, `neq`, `like`, `nlike`, `in`, `nin`, `gt`, `lt`, `gteq`, `lteq`, `from`, `to`, `null`, `notnull`, `finset`.
- `current_page` (`integer`, optional): Page number, starting at 1. Example: 1. Default: `1`.
- `filter_field` (`string`, optional): Field to filter on. Example: sku
- `filter_value` (`string`, optional): Value to compare; with condition_type like, use % as a wildcard; with in, a comma-separated list. Example: 24-MB01
- `page_size` (`integer`, optional): Results per page. Keep it small: without it Commerce returns every match. Example: 20. Default: `20`.
- `sort_direction` (`string`, optional): ASC or DESC. Example: DESC. One of: `ASC`, `DESC`.
- `sort_field` (`string`, optional): Field to sort by. Example: quantity

Example input: `{}`

### `adobecommerce_invoices_list`

Search Invoices · Read-only

Search invoices with one filter (for example order_id or state), sorting and paging.
Returns items[], search_criteria and total_count. Each invoice has entity_id, increment_id, order_id, state, grand_total and created_at.
Use adobecommerce_invoices_list to check billing for orders.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `condition_type` (`string`, optional): Comparison: eq (default), neq, like, nlike, in, nin, gt, lt, gteq, lteq, from, to, null, notnull or finset. Example: like. One of: `eq`, `neq`, `like`, `nlike`, `in`, `nin`, `gt`, `lt`, `gteq`, `lteq`, `from`, `to`, `null`, `notnull`, `finset`.
- `current_page` (`integer`, optional): Page number, starting at 1. Example: 1. Default: `1`.
- `filter_field` (`string`, optional): Field to filter on. Example: order_id
- `filter_value` (`string`, optional): Value to compare; with condition_type like, use % as a wildcard; with in, a comma-separated list. Example: 42
- `page_size` (`integer`, optional): Results per page. Keep it small: without it Commerce returns every match. Example: 20. Default: `20`.
- `sort_direction` (`string`, optional): ASC or DESC. Example: DESC. One of: `ASC`, `DESC`.
- `sort_field` (`string`, optional): Field to sort by. Example: created_at

Example input: `{}`

### `adobecommerce_order_comments_list`

List Order Comments · Read-only

List the status history comments of an order.
Returns items[] with comment, status, created_at, is_customer_notified and is_visible_on_front.
Use adobecommerce_order_comments_list to read an order's history. Use adobecommerce_order_comment_add to add a comment.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): Order entity ID (the id field, not the increment_id shown to shoppers). Example: 42

Example input: `{"order_id":42}`

### `adobecommerce_order_get`

Get Order · Read-only

Get one order by entity ID.
Returns the order with increment_id, state, status, totals, customer, billing_address, items, payment and shipping assignments.
Use adobecommerce_order_get for full order details. Use adobecommerce_orders_list to find the entity ID from an increment_id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): Order entity ID (the id field, not the increment_id shown to shoppers). Example: 42

Example input: `{"order_id":42}`

### `adobecommerce_orders_list`

Search Orders · Read-only

Search orders with one filter (for example status, customer_email or created_at), sorting and paging.
Returns items[], search_criteria and total_count. Each order has entity_id, increment_id, state, status, customer_email, grand_total, created_at and items.
Use adobecommerce_orders_list to find orders. Use adobecommerce_order_get for one order by entity ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `condition_type` (`string`, optional): Comparison: eq (default), neq, like, nlike, in, nin, gt, lt, gteq, lteq, from, to, null, notnull or finset. Example: like. One of: `eq`, `neq`, `like`, `nlike`, `in`, `nin`, `gt`, `lt`, `gteq`, `lteq`, `from`, `to`, `null`, `notnull`, `finset`.
- `current_page` (`integer`, optional): Page number, starting at 1. Example: 1. Default: `1`.
- `filter_field` (`string`, optional): Field to filter on. Example: status
- `filter_value` (`string`, optional): Value to compare; with condition_type like, use % as a wildcard; with in, a comma-separated list. Example: pending
- `page_size` (`integer`, optional): Results per page. Keep it small: without it Commerce returns every match. Example: 20. Default: `20`.
- `sort_direction` (`string`, optional): ASC or DESC. Example: DESC. One of: `ASC`, `DESC`.
- `sort_field` (`string`, optional): Field to sort by. Example: created_at

Example input: `{}`

### `adobecommerce_product_get`

Get Product · Read-only

Get one product by SKU.
Returns the product with id, sku, name, price, status, visibility, type_id, weight, extension_attributes (stock, category links) and custom_attributes.
Use adobecommerce_product_get when you know the SKU. Use adobecommerce_products_list to search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sku` (`string`, required): Product SKU. Example: 24-MB01

Example input: `{"sku":"<sku>"}`

### `adobecommerce_products_list`

Search Products · Read-only

Search catalog products with one filter, sorting and paging.
Returns items[], search_criteria and total_count. Each product has id, sku, name, price, status, visibility, type_id and custom_attributes.
Use adobecommerce_products_list to find products by name, SKU or attribute. Use adobecommerce_product_get for one product by SKU.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `condition_type` (`string`, optional): Comparison: eq (default), neq, like, nlike, in, nin, gt, lt, gteq, lteq, from, to, null, notnull or finset. Example: like. One of: `eq`, `neq`, `like`, `nlike`, `in`, `nin`, `gt`, `lt`, `gteq`, `lteq`, `from`, `to`, `null`, `notnull`, `finset`.
- `current_page` (`integer`, optional): Page number, starting at 1. Example: 1. Default: `1`.
- `filter_field` (`string`, optional): Field to filter on. Example: name
- `filter_value` (`string`, optional): Value to compare; with condition_type like, use % as a wildcard; with in, a comma-separated list. Example: %bag%
- `page_size` (`integer`, optional): Results per page. Keep it small: without it Commerce returns every match. Example: 20. Default: `20`.
- `sort_direction` (`string`, optional): ASC or DESC. Example: DESC. One of: `ASC`, `DESC`.
- `sort_field` (`string`, optional): Field to sort by. Example: updated_at

Example input: `{}`

### `adobecommerce_shipments_list`

Search Shipments · Read-only

Search shipments with one filter (for example order_id), sorting and paging.
Returns items[], search_criteria and total_count. Each shipment has entity_id, increment_id, order_id, items, tracks and created_at.
Use adobecommerce_shipments_list to check fulfillment and tracking.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `condition_type` (`string`, optional): Comparison: eq (default), neq, like, nlike, in, nin, gt, lt, gteq, lteq, from, to, null, notnull or finset. Example: like. One of: `eq`, `neq`, `like`, `nlike`, `in`, `nin`, `gt`, `lt`, `gteq`, `lteq`, `from`, `to`, `null`, `notnull`, `finset`.
- `current_page` (`integer`, optional): Page number, starting at 1. Example: 1. Default: `1`.
- `filter_field` (`string`, optional): Field to filter on. Example: order_id
- `filter_value` (`string`, optional): Value to compare; with condition_type like, use % as a wildcard; with in, a comma-separated list. Example: 42
- `page_size` (`integer`, optional): Results per page. Keep it small: without it Commerce returns every match. Example: 20. Default: `20`.
- `sort_direction` (`string`, optional): ASC or DESC. Example: DESC. One of: `ASC`, `DESC`.
- `sort_field` (`string`, optional): Field to sort by. Example: created_at

Example input: `{}`

### `adobecommerce_stock_item_get`

Get Stock Item · Read-only

Get the legacy stock item of a product: quantity, in-stock flag and stock settings.
Returns item_id, product_id, stock_id, qty, is_in_stock, min_qty, backorders and manage_stock.
Use adobecommerce_stock_item_get to check stock for a SKU. Use adobecommerce_inventory_source_items_list for per-source quantities.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sku` (`string`, required): Product SKU. Example: 24-MB01

Example input: `{"sku":"<sku>"}`

### `adobecommerce_store_configs_get`

Get Store Configuration · Read-only

Get the configuration of the store views: base URLs, locale, currency, timezone and weight unit.
Returns an array of store configs with id, code, website_id, locale, base_currency_code, default_display_currency_code, timezone, weight_unit and base URLs.
Use adobecommerce_store_configs_get to check the store's currency, locale and URLs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `store_codes` (`string`, optional): Only these store view codes, comma-separated. Example: default

Example input: `{}`

### `adobecommerce_category_create`

Create Category · Write

Create a category under a parent category.
Returns the created category with id, parent_id, name, path and level.
Use adobecommerce_category_create to add a category. Use adobecommerce_categories_tree_get to find the parent ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Category name. Example: Travel Bags
- `parent_id` (`integer`, required): Parent category ID (2 is usually Default Category). Example: 2
- `include_in_menu` (`boolean`, optional): Show in the storefront menu. Example: true
- `is_active` (`boolean`, optional): Enable the category. Example: true
- `position` (`integer`, optional): Position among siblings. Example: 1

Example input: `{"name":"<name>","parent_id":2}`

### `adobecommerce_category_product_assign`

Assign Product to Category · Write

Assign a product to a category, or change its position there.
Returns true on success.
Use adobecommerce_category_product_assign to put a product in a category.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `category_id` (`integer`, required): Category ID. Example: 4
- `sku` (`string`, required): Product SKU. Example: 24-MB01
- `position` (`integer`, optional): Position in the category. Example: 1

Example input: `{"category_id":4,"sku":"<sku>"}`

### `adobecommerce_customer_create`

Create Customer · Write

Create a customer account without a password; the customer can set one with Forgot Password.
Returns the created customer with id.
Use adobecommerce_customer_create to add a customer. Use adobecommerce_customers_search first to avoid a duplicate email.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Email. Example: jane@example.com
- `firstname` (`string`, required): First name. Example: Jane
- `lastname` (`string`, required): Last name. Example: Doe
- `addresses` (`array`, optional): Addresses, each with firstname, lastname, street (array), city, region {region_code, region_id}, postcode, country_id and telephone; flag one with default_billing / default_shipping. Example: [{"firstname": "Jane", "lastname": "Doe", "street": ["123 Main St"], "city": "Austin", "region": {"region_code": "TX", "region_id": 57}, "postcode": "78701", "country_id": "US", "telephone": "5125550100", "default_billing": true, "default_shipping": true}]
- `group_id` (`integer`, optional): Customer group ID (1 General, 2 Wholesale, 3 Retailer by default). Example: 1
- `website_id` (`integer`, optional): Website ID. Example: 1

Example input: `{"email":"<email>","firstname":"<firstname>","lastname":"<lastname>"}`

### `adobecommerce_customer_update`

Update Customer · Write

Update a customer's email, name, group or addresses; send the current email, first and last name even if unchanged.
Returns the updated customer.
Use adobecommerce_customer_update after adobecommerce_customer_get. Addresses sent replace the customer's address list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, required): Customer ID. Example: 7
- `email` (`string`, required): Email (current or new). Example: jane@example.com
- `firstname` (`string`, required): First name (current or new). Example: Jane
- `lastname` (`string`, required): Last name (current or new). Example: Doe
- `addresses` (`array`, optional): Addresses, each with firstname, lastname, street (array), city, region {region_code, region_id}, postcode, country_id and telephone; flag one with default_billing / default_shipping. Example: [{"firstname": "Jane", "lastname": "Doe", "street": ["123 Main St"], "city": "Austin", "region": {"region_code": "TX", "region_id": 57}, "postcode": "78701", "country_id": "US", "telephone": "5125550100", "default_billing": true, "default_shipping": true}]
- `group_id` (`integer`, optional): Customer group ID (1 General, 2 Wholesale, 3 Retailer by default). Example: 1
- `website_id` (`integer`, optional): Website ID. Example: 1

Example input: `{"customer_id":7,"email":"<email>","firstname":"<firstname>","lastname":"<lastname>"}`

### `adobecommerce_inventory_source_items_update`

Update Inventory Source Items · Write

Set the quantity and stock status of products at inventory sources (Multi-Source Inventory); records are created or replaced.
Returns an empty response on success.
Use adobecommerce_inventory_source_items_update to change stock. Single-source stores use source_code default.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `source_items` (`array`, required): Records, each {"sku": ..., "source_code": ..., "quantity": ..., "status": 1 in stock or 0 out of stock}. Example: [{"sku": "24-MB01", "source_code": "default", "quantity": 100, "status": 1}]

Example input: `{"source_items":[{"sku":"24-MB01","source_code":"default","quantity":100,"status":1}]}`

### `adobecommerce_order_comment_add`

Add Order Comment · Write

Add a comment to an order's status history, optionally visible on the storefront.
Returns true on success.
Use adobecommerce_order_comment_add for internal notes or customer-visible updates.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `comment` (`string`, required): Comment text. Example: Customer called to confirm the address
- `is_customer_notified` (`integer`, required): 1 if the customer was notified, 0 otherwise. Example: 0. One of: `0`, `1`. Default: `0`.
- `is_visible_on_front` (`integer`, required): 1 to show the comment to the customer in their account, 0 to keep it internal. Example: 0. One of: `0`, `1`. Default: `0`.
- `order_id` (`integer`, required): Order entity ID (the id field, not the increment_id shown to shoppers). Example: 42
- `status` (`string`, optional): Order status to record with the comment. Example: processing

Example input: `{"comment":"<comment>","is_customer_notified":0,"is_visible_on_front":0,"order_id":42}`

### `adobecommerce_order_hold`

Hold Order · Write

Put an order on hold.
Returns true on success.
Use adobecommerce_order_hold to pause processing. Use adobecommerce_order_unhold to release it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `order_id` (`integer`, required): Order entity ID (the id field, not the increment_id shown to shoppers). Example: 42

Example input: `{"order_id":42}`

### `adobecommerce_order_invoice`

Invoice Order · Write

Create an invoice for an order, all items or some, optionally capturing the payment online.
Returns the new invoice ID.
Use adobecommerce_order_invoice to bill an order. capture true charges the customer's payment method.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `order_id` (`integer`, required): Order entity ID (the id field, not the increment_id shown to shoppers). Example: 42
- `capture` (`boolean`, optional): Capture the payment online when the payment method supports it. Example: false
- `items` (`array`, optional): Items to invoice, each {"order_item_id": ..., "qty": ...}; omit to invoice everything. Example: [{"order_item_id": 101, "qty": 1}]
- `notify` (`boolean`, optional): Email the invoice to the customer. Example: false

Example input: `{"order_id":42}`

### `adobecommerce_order_ship`

Ship Order · Write

Create a shipment for an order, all items or some, with tracking numbers; can email the customer.
Returns the new shipment ID.
Use adobecommerce_order_ship to fulfil an order. Get order item IDs from adobecommerce_order_get (items[].item_id).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `order_id` (`integer`, required): Order entity ID (the id field, not the increment_id shown to shoppers). Example: 42
- `comment` (`string`, optional): Shipment comment. Example: Shipped from warehouse B
- `items` (`array`, optional): Items to ship, each {"order_item_id": ..., "qty": ...}; omit to ship everything. Example: [{"order_item_id": 101, "qty": 1}]
- `notify` (`boolean`, optional): Email the customer about the shipment. Example: false
- `tracks` (`array`, optional): Tracking numbers, each {"track_number": ..., "title": ..., "carrier_code": ...}. Example: [{"track_number": "1Z999AA10123456784", "title": "UPS", "carrier_code": "ups"}]

Example input: `{"order_id":42}`

### `adobecommerce_order_unhold`

Release Order Hold · Write

Release an order from hold.
Returns true on success.
Use adobecommerce_order_unhold on an order held with adobecommerce_order_hold.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `order_id` (`integer`, required): Order entity ID (the id field, not the increment_id shown to shoppers). Example: 42

Example input: `{"order_id":42}`

### `adobecommerce_product_create`

Create Product · Write

Create a catalog product.
Returns the created product with id and all saved fields.
Use adobecommerce_product_create to add a simple or virtual product. Use adobecommerce_inventory_source_items_update to set its stock.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `attribute_set_id` (`integer`, required): Attribute set ID; 4 is the Default set. Example: 4. Default: `4`.
- `name` (`string`, required): Product name. Example: Weekender Duffle
- `sku` (`string`, required): Unique SKU. Example: SK-TEST-BAG-01
- `type_id` (`string`, required): simple, virtual, configurable, bundle, grouped or downloadable. Example: simple. One of: `simple`, `virtual`, `configurable`, `bundle`, `grouped`, `downloadable`. Default: `simple`.
- `custom_attributes` (`array`, optional): Other attributes, each {"attribute_code": ..., "value": ...}, such as description, url_key or category_ids. Example: [{"attribute_code": "description", "value": "Roomy duffle bag
"}]
- `price` (`number`, optional): Price. Example: 34
- `status` (`integer`, optional): 1 enabled, 2 disabled. Example: 1. One of: `1`, `2`.
- `visibility` (`integer`, optional): 1 Not visible individually, 2 Catalog, 3 Search, 4 Catalog and search. Example: 4. One of: `1`, `2`, `3`, `4`.
- `weight` (`number`, optional): Weight. Example: 1

Example input: `{"attribute_set_id":4,"name":"<name>","sku":"<sku>","type_id":"simple"}`

### `adobecommerce_product_update`

Update Product · Write

Update a product's name, price, status, visibility, weight or attributes by SKU.
Returns the updated product.
Use adobecommerce_product_update to change product data. Use adobecommerce_inventory_source_items_update for stock.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sku` (`string`, required): Product SKU. Example: 24-MB01
- `custom_attributes` (`array`, optional): Other attributes, each {"attribute_code": ..., "value": ...}, such as description, url_key or category_ids. Example: [{"attribute_code": "description", "value": "Roomy duffle bag
"}]
- `name` (`string`, optional): New name. Example: Weekender Duffle Bag
- `price` (`number`, optional): Price. Example: 34
- `status` (`integer`, optional): 1 enabled, 2 disabled. Example: 1. One of: `1`, `2`.
- `visibility` (`integer`, optional): 1 Not visible individually, 2 Catalog, 3 Search, 4 Catalog and search. Example: 4. One of: `1`, `2`, `3`, `4`.
- `weight` (`number`, optional): Weight. Example: 1

Example input: `{"sku":"<sku>"}`

### `adobecommerce_customer_delete`

Delete Customer · Destructive

Delete a customer account.
Returns true when deleted.
Use adobecommerce_customer_delete to remove a customer for good; confirm the ID with adobecommerce_customer_get first.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, required): Customer ID. Example: 7

Example input: `{"customer_id":7}`

### `adobecommerce_order_cancel`

Cancel Order · Destructive

Cancel an order that has not been invoiced or shipped.
Returns true on success.
Use adobecommerce_order_cancel to void an unpaid order; it can't be undone.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `order_id` (`integer`, required): Order entity ID (the id field, not the increment_id shown to shoppers). Example: 42

Example input: `{"order_id":42}`

### `adobecommerce_product_delete`

Delete Product · Destructive

Delete a product by SKU.
Returns true when deleted.
Use adobecommerce_product_delete to remove a product for good; set status 2 with adobecommerce_product_update to disable it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `sku` (`string`, required): Product SKU. Example: 24-MB01

Example input: `{"sku":"<sku>"}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
