# How to set up The Courier Guy
URL: https://support.starshipit.com/articles/90200000000108-how-to-set-up-the-courier-guy
Canonical: https://support.starshipit.com/articles/90200000000108-how-to-set-up-the-courier-guy
Markdown: https://support.starshipit.com/articles/90200000000108-how-to-set-up-the-courier-guy.md
Updated: 2026-05-25

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Connect The Courier Guy to create South African domestic labels and show live rates in Starshipit.

Connect The Courier Guy to Starshipit to create South African domestic labels and show live rates. This guide explains what you need from The Courier Guy or Shiplogic and how to add the courier to your Starshipit account.

## Before you begin

To connect The Courier Guy to Starshipit, you need:

* API key
* Origin host
* API base URL, if different from the default
* Default service code, if you want a fallback service
* Confirmation of whether you should use sandbox or live
* Product or service codes supplied for your account

If you do not have these details, contact The Courier Guy or Shiplogic. You can also visit [The Courier Guy website](https://thecourierguy.co.za/) or refer to the [Shiplogic API documentation](https://www.shiplogic.com/api-docs).

## Set up The Courier Guy in Starshipit

1. In Starshipit, go to **Settings** > **Couriers** > **Add a new courier**.
2. Select **South Africa** as the shipping from country.
3. Select **The Courier Guy**.
4. Tick **Enable The Courier Guy**.
5. Enter your **API key**.
6. Enter your **Origin host** and **API base URL** if supplied.
7. Enter a **Default service code** if you want Starshipit to use one as a fallback.
8. If The Courier Guy gave you sandbox credentials, tick **Use sandbox**.
9. Click **Save**.

Your The Courier Guy integration is now connected. You can verify the setup by creating a test shipment.

## Add product codes

The Courier Guy uses service codes as Starshipit product codes. Add the service codes supplied for your account in the **Add Product Codes** area.

If product codes are configured, Starshipit only shows rates for those services.

## Limitations

* The Courier Guy supports domestic shipments within South Africa.
* International shipping and returns are not supported through this integration.
* The Courier Guy labels print as 100 x 150 mm labels.
* A separate manifest step is not required.
* Starshipit stores the tracking or waybill number returned by The Courier Guy, but tracking event updates are not currently supported.

## Troubleshooting

**No rates are showing?**

Check that:

* The order is a South African domestic shipment.
* Package details are complete.
* API key, origin host, and API base URL are correct.
* The selected sandbox or live setting matches your credentials.
* Product codes match services enabled on your account.

**Labels are not generating?**

Check that The Courier Guy is enabled, the selected service is available for the shipment, and your account has enough funds. Sandbox accounts may return insufficient-funds errors during shipment creation even when rates work.