> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/sales-channels/apparelmagic-integration.md).

# ApparelMagic Integration

Order Desk can connect to your [ApparelMagic](https://www.apparelmagic.com/) store and import your orders. As orders are fulfilled, shipment details can be sent back to ApparelMagic.

### Setup

To connect to your ApparelMagic store from Order Desk, click on **Manage Integrations** in the left sidebar. Under the **Shopping Carts** tab, look for and enable the ApparelMagic integration.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FOK1lVriZKh3pAvSk8yt0%2Flegacy-adeb831d899910a85547.jpg?alt=media)

Alternatively, search for ApparelMagic from the available integration search.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FQ2v2QmZHFjck8dX9kd9T%2Flegacy-d72d194e85b8c31793bd.png?alt=media)

Enter your API Key and Subdomain information and click to connect.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F3dLieIxrlZ79K1bcXLJx%2Flegacy-a5dcac2b45bb8c67c607.png?alt=media)

Please note that these credentials must be provided by ApparelMagic.

### Integration Settings

Once enabled, set your preferences in the ApparelMagic integration.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F5HbLYS6rlvBf2ha5qDLF%2Flegacy-18898e375c8e3dd95c03.png?alt=media)

#### ApparelMagic Help

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57b0032590336059d4edf94f/images/654c29e3687c016dc15b737f/file-M9Cf6Fecy2.gif)

Click *Need Help Getting Started?* to access ApparelMagic help guides.

#### Check for New Orders

Select how often you want orders to be downloaded from ApparelMagic. Only new orders will be downloaded.

#### Folder for New Orders

Choose the folder where you would like newly downloaded orders from ApparelMagic to be placed. If you would like to work with your own custom folders, please read [this guide](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) for how to create them.

#### Order Status

Choose which orders from ApparelMagic you want Order Desk to download based on their status. You can either download **Select All, Approved, or Pending**.

#### Division Filter

Choose which orders you would like to import based on their division.

#### Warehouse Filter

Use to filter orders based on on the warehouse at the order level.

#### Order ID Format

Use this setting to enable either Customer Order numbers or Internal Order numbers.

#### Sync Tracking Numbers

If you want Order Desk to notify ApparelMagic when orders are fulfilled, enable the Sync Tracking Numbers setting. If tracking details are added to the order, it will be passed back to ApparelMagic immediately.

#### Consolidate Shipments

Enable this to have Order Desk combine multiple packages into a single shipment before sending updates to ApparelMagic.

#### Send Invoices

If you want Order Desk to send your invoices to ApparelMagic, enable the Send Invoices setting.

#### Inventory Location Filter

If you only want to download specific orders, you can use the Inventory Location Filter field to specify which ones you want. Enter multiple locations separated by a comma.

The inventory location name must match exactly as it is on your inventory items in Order Desk. When importing new orders from ApparelMagic, Order Desk will look at the SKUs on the items and compare to the SKUs in your inventory here. Any orders with items for a location that isn’t listed in this field will not be imported.

For this to work, your inventory must be added to Order Desk. The inventory Location should be set on each item. For details, please see [How to Add Inventory](/start-here/getting-started-series/quick-start-orders-and-inventory.md#working-with-inventory) and [How to Store Extra Item Details](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-details.md#store-extra-item-details-in-order-desk).

#### Order Prefix

If you need to add a prefix to your orders as they are downloaded to Order Desk, set that here.

#### Ensure Quantity Picked Imported

By default, Order Desk only imports items from Apparel Magic if the **quantity picked** is greater than 0. Disable this option to bypass that behavior.

#### Ensure Quantity Open Imported

By default, Order Desk only imports items from Apparel Magic if the **quantity open** is greater than 0. Disable this option to bypass that behavior.

**TIP**

If you disable both the **Quantity Picked** and **Quantity Open** options, Order Desk will import all orders from Apparel Magic, regardless of the quantity picked or quantity open.

#### Skip Invoiced Orders

Enable this if you want Order Desk to exclude invoiced orders from the download process.

#### Skip No Pick Tickets

Enable this if you want Order Desk to exclude orders without pick tickets from the download process.

#### Inventory Settings

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57b0032590336059d4edf94f/images/65c2cdb1ffa21909875f09bd/file-v9SUkPq7pa.png)

#### Sync Inventory

If you want Order Desk to sync your inventory availability back to ApparelMagic, enable the Sync Inventory setting. As inventory counts are updated here, Order Desk will pass those numbers back over to ApparelMagic.

#### Vendor

Default vendor name to be passed to ApparelMagic during inventory syncing.

#### Warehouse

Default warehouse name to be passed to ApparelMagic during inventory syncing.

### Manual Imports

You can manually import your orders or inventory items from ApparelMagic at any time. You’ll see the option to do so on the right side of the ApparelMagic settings page.

#### Manually Import Orders

You can manually import orders from ApparelMagic at any time. You can import orders by **Date** if you need to bring in multiple orders, or by a specific **Order ID** if you only need to import one order.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FenlqwVDATuR4Pq7ilFIk%2Flegacy-2c6d2f04acde1052cc6f.png?alt=media)

> **Tip: Importing Orders by Date**
>
> If ApparelMagic has a large number of orders in the selected date range, you may need to click the **Import** button a few times to bring them all in.

#### Download Inventory Items

If you need to import your inventory items from ApparelMagic, click the **Download Inventory Items** button.

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57b0032590336059d4edf94f/images/6514af108820396325b6fe84/file-cztzVsa7D6.png)

For more information on items being tracked by inventory, scroll up to the Inventory Syncing section.


---

# 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, and the optional `goal` query parameter:

```
GET https://help.orderdesk.com/integration-setup-guides/sales-channels/apparelmagic-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
