# Set up iMile Delivery URL: https://support.starshipit.com/articles/1788307200001-set-up-imile-delivery Canonical: https://support.starshipit.com/articles/1788307200001-set-up-imile-delivery Markdown: https://support.starshipit.com/articles/1788307200001-set-up-imile-delivery.md Updated: 2026-11-08 > For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt). > Connect iMile Delivery to Starshipit for eligible Australian domestic rates, labels, pickup booking and tracking. Connect iMile Delivery to Starshipit to retrieve your contracted rates, create PDF labels, book pickups and manage tracking for eligible Australian domestic shipments. ## Before you begin Make sure you have: * An active iMile Delivery merchant account for Australian domestic shipping * Your iMile **Client code** and **Secret key** * The product code or codes enabled for your iMile account * Contracted rates for the lanes you want to ship * Complete sender and delivery addresses in Australia Contact your iMile account manager if you need credentials, product codes or confirmation that your account can service a lane. :::important iMile Delivery is available for Australian domestic shipping only. The rates and services returned depend on your iMile account, configured product codes, parcel details and the selected lane. ::: ## Set up iMile Delivery 1. In UI 2.0, go to **Settings > Couriers > [Add a new courier](https://next.starshipit.com/settings/couriers/add)**. 2. Select **Australia** as the shipping-from country. 3. Select **iMile Delivery**. 4. Tick **Enable iMile**. 5. Enter your **Client code** and **Secret key**. 6. In **Product codes**, add each service code and customer-facing name supplied by iMile. Choose a default service if required. 7. Click **Save**. ## Create labels and track shipments When you process an eligible order, Starshipit uses the product codes and rates configured for your iMile account. It creates an iMile shipment, stores the returned PDF label and saves the tracking information against the order. For a multi-package consignment, add a positive weight and dimensions for every package before creating the label. Starshipit returns the label PDF and saves the tracking information returned by iMile. Open the shipment's tracking link to go directly to iMile tracking with the saved tracking number included. You do not need to enter the number again. ## Choose how to request pickup By default, creating an iMile label does not request pickup. Choose the workflow that matches your collection arrangements with iMile. ### Request pickup when creating shipments 1. In UI 2.0, go to **Settings > Couriers > [iMile](https://next.starshipit.com/settings/couriers/setup/imile)**. 2. Tick **Request pickup when creating shipments**. 3. Click **Save**. 4. Reopen the settings and confirm the option remains selected before creating your next iMile label. This option requests pickup when a new shipment is created. It stays off until you explicitly enable it, including on existing accounts. Reprinting an existing iMile label does not request another pickup. To stop requesting pickup for future shipments, untick the option and save. This does not cancel a pickup already requested with iMile. ### Book a pickup for a chosen date and time Leave **Request pickup when creating shipments** off if you want to arrange collection after creating labels. Follow [Book a courier pickup](/articles/360000133996-book-a-courier-pickup) to select labelled iMile shipments and choose a pickup start and end time on the same date. If pickup was already requested during shipment creation, confirm its status with iMile before making another booking. ## Verify the setup When you are ready to ship: 1. Open an intended order with sender and delivery addresses in Australia. 2. Get rates and confirm that your iMile Delivery product appears. 3. Create the label. If you enabled pickup at creation, this also sends a pickup request to iMile. 4. Check that tracking information is saved against the order. Open its tracking link and confirm the number on iMile's tracking page matches the shipment. 5. Confirm the pickup with iMile if you requested it at creation. If the option is off and you need a pickup, use the [Book a courier pickup](/articles/360000133996-book-a-courier-pickup) steps and check the booking result. A saved setting or a printed label alone does not confirm that iMile has arranged collection. ## Troubleshooting ### No rates are returned Check that the **Client code** and **Secret key** are correct. Confirm that the product code is enabled for your iMile account, that the account has contracted rates for the lane, and that the sender and delivery addresses are both in Australia. ### A label cannot be created Check that the order has complete recipient details, parcel weight and dimensions. For multi-package shipments, make sure every package has a positive weight and dimensions. If the issue continues, contact iMile to confirm that your account and service are enabled for shipment creation. ### Pickup is missing or uncertain Check which pickup workflow you used. For pickup at creation, reopen iMile settings and confirm **Request pickup when creating shipments** was saved before the shipment was created. Changing it after printing or reprinting the label does not send a new pickup request. For a scheduled pickup, check the result in **Pickups**. If the request failed, the result is unclear or no booking reference was returned, confirm its status with iMile before submitting again. Does Starshipit support iMile Delivery? Yes. Starshipit supports iMile Delivery for eligible Australian domestic shipments, including account-specific product codes, contracted rates, PDF labels and tracking. Can I book an iMile pickup in Starshipit? Yes. You can opt in to requesting pickup when new shipments are created, or leave that option off and book a pickup after creating labels to choose a date and time. Pickup availability depends on your iMile account; confirm the collection with iMile before requesting it again.