> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Adobe Commerce with Adobe Commerce as a Cloud Service – StackOne Hub

> Link a Adobe Commerce account in the StackOne Hub using Adobe Commerce as a Cloud Service. End-user guide to authorize the integration and start using Adobe Commerce actions.



\> \[!WARNING]
\>
\> Use this method only for Adobe Commerce as a Cloud Service instances, whose REST endpoint looks like https\://\<server>.api.commerce.adobe.com/\<tenant-id>. CMS page and block actions are not available because the Cloud Service REST API does not include them.



Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Create an OAuth Server-to-Server credential

The credential gives you the Client ID, Client Secret and Organization ID you enter below. You need developer access to the **Adobe Commerce as a Cloud Service - Backend - Commerce Cloud Manager** product in your organization.

**1. Open your project**

Sign in to the [Adobe Developer Console](https://developer.adobe.com/console) and select the organization that owns your Commerce instance.

<ul>
  <li>Open an existing project or create a new one.</li>
</ul>

**2. Add the Commerce API**

In your workspace, open **Add service** and select **API**.

<ul>
  <li>Select **Adobe Commerce as a Cloud Service** and click **Next**.</li>
  <li>On the **Configure API** page, select **OAuth Server-to-Server** and click **Save configured API**.</li>
</ul>

**3. Copy the credential values**

Open the **OAuth Server-to-Server** credential of the workspace.

<ul>
  <li>Copy the **Client ID**, the **Client Secret** and the **Organization ID** (it ends in `@AdobeOrg`).</li>
  <li>Note the **Technical account email**. You add it to Commerce in the next section.</li>
  <li>Check that the credential's scopes include `commerce.accs`.</li>
</ul>

## Give the technical account Commerce permissions

REST calls run as the credential's technical account, so it must be an Admin user of the Commerce environment you connect, with a role that grants the resources you need. Each environment (for example production and staging) needs its own credential and its own Admin user.

**1. Assign a role**

Enables actions: Add Item To Cart, Add Order Comment, Cancel Order, Create Cart, Create Cart Price Rule, Create Category, Create Credit Memo (Refund), Create Customer Group, Create Invoice, Create Product, Create Shipment, Delete Cart Price Rule, Delete Category, Delete Coupon, Delete Customer, Delete Customer Group, Delete Product, Generate Coupons, Get Cart, Get Cart Price Rule, Get Category, Get Credit Memo, Get Customer, Get Customer Group, Get Invoice, Get Order, Get Product By SKU, Get Shipment, Get Stock Status, List Cart Price Rules, List Categories, List Coupons, List Credit Memos, List Customer Groups, List Customers, List Invoices, List Orders, List Products, List Shipments, List Source Items, List Store Configurations, List Store Groups, List Store Views, List Tax Classes, List Tax Rates, List Tax Rules, List Websites, Remove Cart Item, Send Invoice Email, Update Cart Item, Update Cart Price Rule, Update Category, Update Customer, Update Customer Group, Update Product, Update Source Items

In the Commerce Admin, add the technical account email as an Admin user and assign it a role.

<ul>
  <li>Roles are managed in **System** > **Permissions** > **User Roles**.</li>
  <li>Under **Role Resources**, choose **All** or select the resources listed below. Actions that use a resource the role does not include return 401 Unauthorized.</li>
</ul>

<ul>
  <li>
    Magento\_Backend::store
  </li>

  <li>
    Magento\_Cart::manage
  </li>

  <li>
    Magento\_Catalog::catalog\_inventory
  </li>

  <li>
    Magento\_Catalog::categories
  </li>

  <li>
    Magento\_Catalog::products
  </li>

  <li>
    Magento\_Customer::customer
  </li>

  <li>
    Magento\_Customer::manage
  </li>

  <li>
    Magento\_Customer::delete
  </li>

  <li>
    Magento\_Customer::group
  </li>

  <li>
    Magento\_InventoryApi::source
  </li>

  <li>
    Magento\_InventoryApi::stock\_source\_item\_assign
  </li>

  <li>
    Magento\_Sales::actions\_view
  </li>

  <li>
    Magento\_Sales::cancel
  </li>

  <li>
    Magento\_Sales::comment
  </li>

  <li>
    Magento\_Sales::invoice
  </li>

  <li>
    Magento\_Sales::sales\_creditmemo
  </li>

  <li>
    Magento\_Sales::sales\_invoice
  </li>

  <li>
    Magento\_Sales::shipment
  </li>

  <li>
    Magento\_SalesRule::quote
  </li>

  <li>
    Magento\_Tax::manage\_tax
  </li>
</ul>

## Find your REST endpoint

Open [Adobe Experience Cloud](https://experience.adobe.com), go to the Commerce Cloud Service instances page, and click the information icon next to your instance. Copy the **REST endpoint**, for example `https://na1.api.commerce.adobe.com/AbCYab34cdEfGHiJ27123`. Do not add `/rest` or `/V1`.

## Choose a Store Code (optional)

Cloud Service selects the store scope with a `Store` header instead of the URL. StackOne sends the **Store Code** you enter as that header.

<ul>
  <li>Leave it empty to send no `Store` header.</li>
  <li>`default` targets the default store view, and `all` runs requests in the global scope.</li>
  <li>Or enter a specific store view code, as listed by the List Store Views action.</li>
</ul>

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/connect/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.