> 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/shipping-services/starshipit-integration.md).

# Starshipit Integration

Order Desk can download orders from your shopping carts and send them to [**Starshipit**](https://starshipit.com/) for fulfillment. After submission, you can also use the integration to request rates, then create and print labels directly from your orders in Order Desk.

As orders are fulfilled, tracking details will automatically flow back to Order Desk and update your carts.

### Setup

To connect to Starshipit, click on the **Manage Integrations** link in the left sidebar and under the **Shipping** tab find and enable the Starshipit integration:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/68f2474e003f671874b70a63/file-I2uS5I5AO6.png)

Alternatively, search for *Starshipit* from the available integration search and click **Enable**:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/68f247619c3e4830c6ea1f84/file-TflQUanRH1.png)

Once enabled, enter your **Starshipit API Key** and **Subscription Key**, then click **Connect**:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/68f247a0003f671874b70a66/file-WvY7vz1841.png)

Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by Starshipit.

### Settings

After you have connected the integration, you can apply any necessary details or preferences to the settings.

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/68f247c7e9662630bd34883e/file-KkoQ3pm0ms.png)

#### After Import, Move To

Select the folder you want orders to be moved into after they are successfully sent to Starshipit.

You can use one of the default folders already in your store or create your own. Read the [**Working with Folders**](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide for more information.

#### After Shipment, Move To

Select the folder orders should be moved to when Starshipit sends tracking details back to Order Desk about them.

#### Default Unit

Choose the unit of measurement for package dimensions and weights (options are LBS/IN or KG/CM)

#### Default Dimensions

Select the default dimensions for your packaging.

#### Print Preference

Choose whether you want labels to **Print Immediately** or **Not Print Automatically**. This is helpful if you want to create labels but delay printing them.

#### Default Shipper Information

Set your default return address in the **Default Shipper Information** section. This address will be used for all orders.

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/68f2482513893a08a75b7b31/file-vDZgfHWIWX.png)

#### Product Settings

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/68f2484ce9662630bd348843/file-oa8kf9dgbk.png)

For more information on what these product settings in the Starshipit integration are for and how to use them, read the [**Fulfillment Integration Product Settings**](/integration-setup-guides/fulfillment-services/fulfillment-integration-product-settings.md) guide.

#### Starshipit Label Creator

A label creator will display beneath the product details on every order that has previously been submitted to Starshipit from Order Desk.

You can use this section to further adjust your package dimensions, fetch rates, and then purchase your intended labels:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/68f248e99c3e4830c6ea1f8e/file-cRTjNi9wM7.png)

You can also purchase labels automatically with rules. [More info here.](#rule-events)

#### Order Level Details

If you’re sending orders to Starshipit for fulfillment, the following fields can be added as checkout data or order metadata to be passed through to Starshipit on an order by order basis.

If you are unfamiliar with checkout data, see the [**How to Work with Checkout Data**](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide.

| Field Name             | Field Description                                                                                                                       |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| reference              | By default, the order reference is set to *Order Desk*. You can enter a different value here if you prefer.                             |
| shipping\_description  | Use this field to override the shipping description sent to Starshipit. If left blank, the shipping method from the order will be used. |
| signature\_required    | Set this to **1** if a signature is required upon delivery.                                                                             |
| return\_order          | Set this to **1** if the order is a return.                                                                                             |
| package\_weight        | Use this to override the weight of the package.                                                                                         |
| package\_length        | Use this to override the length of the package.                                                                                         |
| package\_width         | Use this to override the width of the package.                                                                                          |
| package\_height        | Use this to override the height of the package.                                                                                         |
| delivery\_instructions | Use this field to pass delivery instructions for the shipment.                                                                          |

#### Starshipit Rules Reference

In addition to the [**general set of rule events and actions**](/resources/rules-reference-events-filters-and-actions.md) in Order Desk, Starshipit includes a number of rule events and actions that are specific to the integration. These aren’t found directly on the integration page. Instead, you’ll need to use the **Rule Builder** to access them.

If you’re new to using rules in Order Desk, we recommend starting with our [**How to Work With Rules**](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) guide.

#### Rule Events

To find Starshipit-specific rule events, type *starshipit* into the **Event** dropdown menu in the **Rule Builder**.

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/68f24db79c3e4830c6ea1fa9/file-uC0w8l6YPW.png)

| **Event**                                                         | **Description**                                                                              |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| *Starshipit Label Created*                                        | Triggered when a shipping label is successfully created from Starshipit.                     |
| *Order Scheduled to Starshipit*                                   | Triggered immediately after an order is scheduled to be sent to Starshipit.                  |
| *Before Order Submitted to Starshipit*                            | Triggered just before an order is sent to Starshipit. Useful for making last-minute updates. |
| *After Order Submitted to Starshipit*                             | Triggered after an order has been successfully submitted to Starshipit.                      |
| *Order Not Submitted to Starshipit Because of General Error*      | Triggered when a general error prevents the order from being submitted.                      |
| *Order Not Submitted to Starshipit Because of Invalid SKU*        | Triggered when one or more SKUs are not valid in Starshipit.                                 |
| *Order Not Submitted to Starshipit Because No Products Available* | Triggered when no valid products were found on the order.                                    |

#### Rule Actions

Starshipit also supports specific rule actions that you can apply to your orders. These can be found in the **Actions** dropdown by searching for *starshipit*:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/68f24deb05b9c378d26887ef/file-fnbLEWNkyb.png)

| **Action**                   | **Description**                                                                                                       |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| *Create Starshipit Label*    | Attempts to automatically purchase a label from Starshipit. This will attempt to create the cheapest label available. |
| *Submit Order to Starshipit* | Sends an order from Order Desk to Starshipit.                                                                         |


---

# 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/shipping-services/starshipit-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.