Skip to main content

Connect Starshipit

Connecting Starshipit takes three parts: create the connection with your keys, paste SKU.io's webhook address into Starshipit so tracking flows back, and tell SKU.io which warehouses ship through Starshipit.

Before you begin​

  • You need permission to connect integrations.
  • In Starshipit, go to Settings → API and copy the API Key and Subscription Key.
  • You can connect one Starshipit account.

Create the connection​

  1. Go to Apps & Integrations, open Shipping & Fulfillment, and choose Starshipit. The New Starshipit Integration page opens.

    The New Starshipit Integration page with Instance Name, API Key, Subscription Key, and Webhook Secret fields

  2. Enter an Instance Name. It defaults to Starshipit.

  3. Paste the API Key and Subscription Key.

  4. Leave Webhook Secret blank, unless you've turned on signature checking for webhooks in Starshipit. Then enter the same secret here. With a secret saved, SKU.io rejects any webhook that isn't signed with it, so the two must match.

  5. Leave Enable automatic order syncing on, and check the Order Start Date (30 days ago by default).

  6. Click Create Integration.

What you'll see: the Dashboard opens and the first order sync starts. SKU.io doesn't test the keys when you create the connection, so open Settings and click Test Connection to confirm them.

Paste the webhook address into Starshipit​

Starshipit tells SKU.io about labels, tracking, and cancellations through a webhook, and you set it up by hand.

  1. In SKU.io, open Settings. Under Webhook Settings, copy the Webhook URL.
  2. In Starshipit, go to Settings → Webhooks and paste it as your webhook endpoint.

Without the webhook, tracking still arrives, but only when SKU.io checks Starshipit every 30 minutes.

Saved keys and the webhook secret​

Once saved, the API Key, Subscription Key and Webhook Secret fields on Settings start blank and read Saved — enter a new value to replace it. Leave a field blank to keep what's saved; type a new value only to replace it.

With a Webhook Secret saved, SKU.io rejects every webhook that's unsigned or signed with a different secret, and tracking from webhooks stops until the same secret is entered in Starshipit under Settings → Tracking & notifications. To accept unsigned webhooks again, tick Remove the saved secret (accept unsigned webhooks) and save.

Choose which warehouses ship through Starshipit​

  1. Open the Fulfillments tab.
  2. Turn on Enable Fulfillment for each warehouse Starshipit ships from.
  3. Turn on Automate Fulfillment too if SKU.io should submit that warehouse's orders to Starshipit automatically. Leave it off to submit each one yourself.
Pick in SKU.io, ship in Starshipit

If your team picks with pick lists in a warehouse that ships through Starshipit, turn off Fulfill from pick lists under Settings → Fulfillment → Warehouse Locations. Otherwise Fulfill picked items on a completed pick list marks the orders fulfilled in SKU.io without sending them to Starshipit.

Map carriers and services​

Open Shipping Methods. The list shows each carrier and service Starshipit has used on your orders. Pick the SKU.io shipping method each one means, or select several rows and use Apply to selected. The mapped method decides the carrier name SKU.io sends to your sales channel with the tracking number.

Set what syncs​

Settings → Sync has a Sync Schedule (Active or Paused) and two switches under What syncs: Import tracking from Starshipit and Push orders to Starshipit. With pushing off, an order is refused with "Starshipit order push is turned off in Sync settings".

Dropship orders from retailers​

On an order you ship for a retailer under dropship for retailers, the label names the retailer as the sender, with the retailer's support email and phone when set. The street address stays your warehouse's, because carriers need the real origin. Prices are left off the order, except on an international parcel, which keeps its item value for customs; customs paperwork for an international parcel names the retailer as the shipper.

Next steps​

Last verified: