For the complete documentation index, see llms.txt. This page is also available as Markdown.

Setup

Complete the five steps of the GLS Connector Setup wizard and test the connection to GLS.

The GLS Connector Setup wizard guides you through the basic setup in five steps. Afterwards, the company is connected to your GLS account and ready for the first test shipment. You need the GLS Super User permission set.

The screenshots dated 20.10.2026 show our demo sandbox with GLS Connector 26.13.40.1015, based on 26.13.40, in the German user interface. Credentials have been removed and the Contact ID is redacted. Depending on your window size, the layout may differ.

Open the wizard

  • Search for Assisted Setup and choose Set up the GLS Connector, or

  • open GLS Configuration and choose the Assisted Setup action.

Use Next and Back to move between the steps. If not all fields are visible, scroll down within the wizard. You can also open it directly through search (Alt+Q) with GLS Connector Setup.

The five steps

1

Welcome to the GLS Connector

The wizard explains what will be set up. Have your GLS credentials ready.

Welcome page of the GLS Connector wizard in the German user interface, with the „Weiter“ (Next) button.
The wizard starts with the Welcome to the GLS Connector page, shown here in German. Choose Next to get started.
2

API Connection

  1. In the Environment field, select the sandbox first. The API Base URL is set to match the environment.

  2. Enter the Client ID, Client Secret and Contact ID from your GLS sandbox credentials.

  3. Choose Test Connection.

Test Connection saves your entries and then attempts to sign in to GLS. No label and no shipment is created. The action is only visible in this step.

API Connection page in the German user interface with Environment set to Sandbox, the API Base URL, empty Client ID and Client Secret fields, and a redacted Contact ID.
Enter your own credentials on the API Connection page. In the German-language screenshot, Client ID and Client Secret are empty and the Contact ID is redacted.
3

Alternative Shipper Address

Optionally, enter a different shipper address: Name/Name 2, Street/Street No., ZIP Code/City/Country Code and E-Mail/Phone No. Use this step if your goods are not shipped from the company address.

Upper part of the optional alternative shipper address in the German user interface, with empty input fields for name and address.
If required, enter the name and address of your alternative shipper address. The German-language screenshot shows empty input fields.
Address section scrolled down in the German user interface, with empty fields for Country Code, E-Mail and Phone No.
Scroll down to enter the Country Code, E-Mail and Phone No. In the German-language screenshot, all fields are empty.
4

Label Options and Features

Select the Label Format (PDF, PNG or Zebra), the Template Set, and the default product and service. Only enable features that your GLS contract actually covers, for example Enable Hazardous Goods, Enable Returns or Enable Pickup. The toggles are located under Optional Features.

Label settings in the German user interface with the example values PNG and NONE, default product Parcel and default service „Kein“ (None).
Define the label settings and the default product and default service. The values shown (PNG, NONE, Parcel and None, displayed as „Kein“ in German) are only an example.
Optional Features section in the German user interface with toggles for ShopDelivery, returns, pickup, hazardous goods, international shipping and direct shipments.
Scroll to the Optional Features section to turn individual features on or off. The toggles do not replace contractual approval by GLS.
5

You are all set!

Choose Finish to save the setup. The assisted setup is marked as completed.

Last page of the wizard in the German user interface with the message „Alles erledigt!“ (You are all set!) and the „Fertigstellen“ (Finish) button.
The last page displays You are all set! (shown in German as „Alles erledigt!“). Choose Finish to save your settings and complete the wizard.

Check the result

  • The connection test was successful.

  • In GLS Configuration, Environment, Label Format and Default Product are set as selected.

  • In Assisted Setup, Set up the GLS Connector is marked as completed.

If the connection test fails

  1. Check that the credentials belong to the selected environment. Sandbox credentials do not work in production, and vice versa.

  2. Check the Client ID and Client Secret for leading or trailing spaces.

  3. Check the HTTP permission in the extension settings. If there is a matching entry in the API Call Log, read the response from GLS.

  4. If sign-in errors persist, contact GLS to have your credentials confirmed.

Sandbox, production and stored credentials

  • Use separate GLS credentials for sandbox and production.

  • When you switch the environment, the app sets the matching API address and warns you that the previous credentials would continue to be used.

  • Leaving Client ID or Client Secret empty keeps the previously stored values. Therefore, always enter the new values after switching the environment.

  • Credentials are stored per company in the app's protected storage.

Continue with the setup