How to configure Starlinks Global (STARLINKS) in techSHIP [Guide]

Last updated: October 28, 2026

This guide explains how to add and configure this carrier connection, review its available carrier-specific settings, and understand the shipment requirements and operational constraints that apply.

Carrier Requirements and Specifications

This section summarizes onboarding requirements and lists confirmed carrier-specific constraints.

To review all supported carriers and their specific requirements, see: 📄 techSHIP supported Carriers - Master List [Guides List].

Onboarding Requirements

The Starlinks Global integration supports:

  • Void

  • Collect (COD)

  • Label References

  • Sender Address Override

  • Multi-package Shipments

  • Manifests

Information to be Provided

The following credential is mandatory to connect to Starlinks Global. Ensure you have it available before starting the setup:

DATA ELEMENT

SOURCE (HOW TO OBTAIN)

Api Key

Obtain the API credential for your account from Starlinks Global.

Have the sender company, ship-from address, recipient address, and recipient contact information available before processing shipments. For international shipments, coordinate the required customs documents and tax registrations with Starlinks Global.

Specifications and Constraints

Operational Details

Starlinks Global is a middle-mile carrier that delegates final-mile delivery to another carrier. The final-mile carrier is selected by Starlinks Global, and this integration does not use carrier splits.

The confirmed service codes are SLG006 and SLG008 for US domestic shipments, and SLG001 for international shipments. Confirm account and destination eligibility with Starlinks Global.

Manifests and voids: Finalizing a manifest submits the applicable parcels through Mass Accept. A parcel can be voided while it remains in Created status and has not been accepted. After acceptance, contact Starlinks Global if it needs to be canceled.

Collect (COD): Collection amounts are configured per package. Use this option only for destinations and services where Starlinks Global permits COD.

Bill of Lading (BOL): This integration does not provide a BOL.

  • Addresses: Both the resolved sender and destination require a country, postal code, first street-address line, and city. The sender also requires a company name, and the destination requires a recipient name. For US domestic shipments, provide the state for both addresses.

  • Recipient contact: US domestic shipments require at least a phone number or an email address. Other shipments require both.

  • Package weight and description: Each package requires positive weight and a usable description, supplied either on the package or through the Client Account's Default package Description.

  • Dimensions: If all dimensions are absent, they are omitted. If any dimension is supplied, enter positive length, width, and height values. Weight is sent in pounds and dimensions in inches.

  • Item details: For supplied item lines, provide a positive whole-number quantity, a description, a positive unit price, and a two-letter country-of-origin code. Outside the US domestic flow, also provide SKU and HS code. Each international package requires at least one item line.

  • Item values: Decimal unit prices, including cents, are preserved. Keep package, COD, and item currencies consistent.

Configuring a Baseline Account

A Baseline Account serves as the fundamental connection point between techSHIP and the carrier's system. It acts as a template that holds the credentials and fundamental properties required to process shipments.

The techSHIP AI Assistant is available from the Carrier page for supported Carrier configuration tasks. For detailed conceptual information and advanced configuration, refer to 📄 techSHIP AI Assistant: Overview & Availability [Information].

Adding a Carrier

Before adding an account, you must ensure the Carrier entity is available for your location.

  1. Click My Carriers from the left menu under the Carriers category.

  2. Click Add Carrier.

  3. Select the desired Carrier.

You may encounter additional messages depending on the carrier status or your plan:

  • Subscription Required (⭐): If the carrier has a star icon, you will see a message stating "To use this carrier, a subscription upgrade is required." Press Contact to Upgrade to proceed.

  • Carrier Suspended: If the carrier has not been used for an extended period, you will see a message stating “This carrier is currently on hold...” Click Request Assistance to reactivate it.

  • Setup Fee Waived: If a carrier from the same carrier group is already installed in your location, you can add this carrier without incurring additional fees.

  1. If needed, update the carrier Name.

  2. Click Add Carrier.

If the purchase confirmation appears, complete the following steps:

  • Review the purchase notice and any applicable charge information.

  • Optionally enter a PO Number.

  • Select I am authorized to complete this purchase on behalf of my organization.

  • Click Purchase to confirm the Carrier addition.

Preview

Once the Carrier is added, you will be automatically redirected to the Carrier page to continue setting it up.

  1. Enter the Code of the Carrier as it appears in your host system.

The Code of the Carrier must match exactly the value defined in the host system. Any discrepancy (including casing or extra spaces) may prevent the carrier from working correctly.

  1. Click Save.

If your facility utilizes the centralized Pickup Schedule, we highly recommend adding this new carrier to your calendar now. While not required to process labels, this ensures accurate induction metrics for your Insights dashboards. To learn more, see 📄 Understanding the Centralized Pickup Schedule & Expected Induction Logic [Information].

Adding a Baseline Account

From the Carrier page, click Add Account to create a new Baseline Account.

You will be redirected to the Baseline Account page to complete the setup.

Entering incorrect values will prevent the system from generating shipping labels.

General Tab

In the General tab, define the administrative properties:

  • Name: Enter a descriptive name for the account.

Enter a descriptive name based on unique properties. E.g.:

  • Carrier Name - Account Number (CarrierX - 123456789)

  • Carrier Name - Consolidator Name (CarrierY - MyConsolidator)

  • Carrier Name

  • Usage: Select the most suitable option:

    • Test: Used for sandbox or onboarding purposes.

    • Production: Used for live shipping.

Keep the Status field set to its default Active value. An account must be Active to remain fully editable. For detailed conceptual information on account statuses, refer to 📄 How to Inactivate and Activate a Carrier Baseline Account [Step-by-Step Guide].

Carrier Tab

Credentials

Api Key: Enter the credential provided for your Starlinks Global account. This required field uses a masked password control.

Sender Address

Under Sender address, complete Address 1, City, Zip, and Country. Enter State/province as applicable, including the state for a US domestic origin. Use Address 2 and Address 3 when needed.

A resolved sender country is required for processing even though Country is not marked as required in the form.

This provides the default sender street address. Configure the sender identity in the Client Account; client address overrides or the Order's own ship-from information can supply a different origin.

Labels Tab

Set Mode to PDF or ZPL for native carrier label output.

To choose which labels are retained, set Labels to save in the Baseline Account's Carrier tab:

  • Last mile label: Retain the final-mile carrier label.

  • Middle mile label: Retain the Starlinks Global system label.

  • Both: Retain both labels for each package.

If Labels to save is unset, the final-mile label is retained.

PNG output: techSHIP can convert the returned ZPL label to an image for PNG output; Starlinks Global does not return a native PNG label.

Finalizing the Setup

Once you have entered the required information, click Save.

After you save the Baseline Account, check whether the Registration tab or a registration status badge is available.

If neither is available, the Carrier does not use this Registration workflow in techSHIP. If registration is still pending, open the Registration tab and press Registration, then complete 📄 How to Register a Carrier Baseline Account [Step-by-Step Guide] before creating shipments.

From the Carrier page, you can now see the Baseline Account listed with the administrative status Active. The Active status is separate from the account's registration status.

The Baseline Account configuration is now saved. You can continue with Configuring a Client Account below to assign the Baseline Account to a specific Client.

Configuring a Client Account

Adding an Account

Before adding a Client Account, ensure that the Client has been created. For instructions creating a Client, see: 📄 10 - How to create a Client profile [Step-by-Step guide].

  1. Click Clients from the left menu under the Clients section.

  2. Click the Edit icon for the desired Client.

  3. Click Add Accounts.

  4. Optionally, use the Search box to search by Baseline Account Name or Carrier.

  5. Select the Baseline Accounts that will serve as the foundation for your new Client Accounts.

  6. Click Add Accounts.

    A toast notification will confirm the accounts were successfully assigned. Click the Refresh icon if recently added accounts are not displayed.

  1. Click Edit on each newly created account.

  2. Configure the available options in each tab (except Carrier).

For complete instructions on configuring this settings, see 📄 How to configure the Billing Account General Options tab [Step-by-Step guide].

Carrier Tab

Service and Shipment Defaults

  • Service code: Select the client service. Use SLG006 or SLG008 for the confirmed US domestic flow, or SLG001 for international shipping.

  • Override WMS Service Code: Enable to use the configured client service instead of the service supplied by the Integrated system.

  • Currency Code: Set the default currency for package and COD values. The Order's Currency Code takes precedence; if neither is set, USD is used. An item's own currency takes precedence for that item's value.

  • Content category: Select Commercial goods, Gifts, Documents, or Other. The Order's Content category takes precedence. If neither is set, Commercial goods is used.

  • Incoterm: For international shipments, select DDU or DDP as the default. The Order's Incoterm takes precedence. If both are unset, the value is omitted and Starlinks Global applies its DDU default. Leave domestic shipments at [Not Set].

  • Default package Description: Enter the description to use when a package's own description is missing, empty, or whitespace-only. An explicit package description takes precedence. This default does not replace item-line descriptions.

Sender Identity and Address Override

Complete Sender name and Sender company. Both are required in the Client Account form and remain visible when Override sender address is disabled.

Enter Phone and Email when applicable. These contact fields also remain visible independently of the address override.

Enable Override sender address to use the client's ship-from address instead of the inherited Baseline address. Complete Address 1, City, Zip, and Country. Add State/province, Address 2, and Address 3 as applicable.

The client's sender identity can apply even when Override sender address is disabled. An Order's own ship-from information takes precedence over these account settings.

Shipper Customs and Tax Identifiers

  • Shipper Vat, Shipper Eori Number, Shipper Ioss Number, and Shipper Gst: Enter the applicable default registrations. Corresponding Order-level values take precedence.

  • Shipper Tax Id: Enter the general shipper tax identifier when applicable.

Blank tax identifiers are omitted.

Specifying Rate Shopping Service Codes

Rate Shopping is not supported by this integration. Select an applicable Service code for shipment processing.

Label References

Starlinks Global supports Reference 1. Configure it in the Labels group of the Client Account's General tab.

For a comprehensive guide on how to use label references, see: Using order References in your labels [Step-by-Step guide].

Finalizing the Setup

Once you have entered the required information, click Save.

With the account configured and requirements verified, you can now proceed to process orders as described below.

Configuring an Order

The steps described in this section are not required for carrier setup, and they are offered as an optional review if further order-level configuration is required.

Follow the UI Navigation steps in 📄 05 - How to edit an order’s information - [Step-by-Step guide], using the carrier-specific values provided in this guide.

Carrier Tab

Configure the following Starlinks Global fields in the Order's Carrier tab when needed:

  • Service code: Select the appropriate service for the destination.

  • Currency Code: Set the order currency to override the Client Account default.

  • Pudo id: Enter the pickup-point identifier when applicable to the selected service.

  • Content category: Override the Client Account's default category.

  • Incoterm: For international shipping, select DDU or DDP to override the client default. If both are unset, Starlinks Global applies DDU. Leave domestic shipments at [Not Set].

  • Invoice number: Enter the applicable invoice reference.

  • Consignee Vat, Consignee Eori Number, and Consignee Id number: Enter the recipient's applicable customs or tax identifiers.

  • Shipper Vat, Shipper Eori Number, Shipper Ioss Number, and Shipper Gst: Enter shipper registrations that override the corresponding Client Account defaults.

Packages Tab

Open the applicable package's details in the Order's Packages tab:

  • Commodity Description: Enter a package-specific description. If it is missing, empty, or whitespace-only, the Client Account's Default package Description is used. Processing is blocked if neither provides a usable description.

  • COD Amount: Enter the collection amount for that package when COD is applicable. Its currency comes from the Order's Currency Code, then the Client Account's Currency Code, with USD used if both are unset.

Click Save to apply the order-level changes. After the Order is updated, continue with the standard shipping workflow.

Troubleshooting

  • Authentication fails: Verify Api Key in the Baseline Account's Carrier tab. Confirm with Starlinks Global that the credential belongs to the intended account.

  • A package description is missing: Enter Commodity Description for the affected package or configure Default package Description in the Client Account's Carrier tab. The default does not resolve a missing item-line description.

  • Address or contact validation fails: Review the resolved sender and recipient addresses. Check the sender company and recipient name, and provide the required recipient phone or email for the shipment flow. Complete both states for US domestic shipments.

  • Package or item validation fails: Check positive package weight, all three dimensions when dimensions are supplied, and complete item data. International packages need at least one item line; non-US flows require SKU and HS code on supplied items.

  • No rates are returned: This integration does not provide Rate Shopping. Select the applicable Service code directly and confirm its account and destination eligibility with Starlinks Global.

  • An unexpected DDU value appears: Review Incoterm in the Client Account and Order. The Order value takes precedence; if neither is supplied, Starlinks Global applies DDU. Keep both unset for domestic shipments.

  • The expected label is missing: Check Labels to save in the Baseline Account's Carrier tab and Mode in its Labels tab. Review the package-specific error to identify whether the missing label is the final-mile or system label. Confirm whether the parcel was created before processing again.

  • A void is rejected: Check whether the parcel has already been accepted. Accepted parcels cannot be canceled through the API; contact Starlinks Global for cancellation. For other failures, retain the carrier error and the parcel's system tracking number.

  • Manifest acceptance fails or is unconfirmed: Review the parcel-specific results. Reconcile failed or unconfirmed parcels with Starlinks Global before resubmitting, and do not resubmit parcels whose acceptance is already confirmed.