> For the complete documentation index, see [llms.txt](https://docs.violet.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.violet.io/ecom-platforms/magento.md).

# Magento

Magento (now Adobe Commerce) is an open-source ecommerce platform for mid-market and enterprise merchants. Violet supports Magento 2.x via its REST API, with enhanced functionality available through an optional Violet Magento extension.

## Connection

Merchants provide an **API Token**, **API Secret**, and their **Store URL**.

### Violet Extension (Recommended)

The Violet Magento extension unlocks additional capabilities and is recommended for most merchants. When the extension is installed, Violet can:

* Access store admin contact information
* Receive real-time webhook notifications for product and order changes
* Sync Violet's internal token directly to the merchant's store

Without the extension, Violet operates in **API-only mode**, which provides full order submission and product sync but relies on scheduled sync jobs rather than real-time events.

The extension is installed via **Composer 2+** and requires Magento 2.4.x.

### Bearer Tokens (Magento 2.4.4+)

Magento 2.4.4 and newer may require **standalone Bearer tokens** to be enabled. Merchants should verify this setting if they encounter authentication errors after providing valid credentials.

## Notable Behavior

* **Multi-store**: Magento supports complex multi-store and multi-website configurations. Violet connects to the default store view unless merchant configuration specifies otherwise.
* **No native scopes**: Unlike other platforms, Magento does not have granular API access scopes. Valid credentials provide full API access.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.violet.io/ecom-platforms/magento.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.