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.
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
API Connection
In the Environment field, select the sandbox first. The API Base URL is set to match the environment.
Enter the Client ID, Client Secret and Contact ID from your GLS sandbox credentials.
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.

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.


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.


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
Check that the credentials belong to the selected environment. Sandbox credentials do not work in production, and vice versa.
Check the Client ID and Client Secret for leading or trailing spaces.
Check the HTTP permission in the extension settings. If there is a matching entry in the API Call Log, read the response from GLS.
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
Setup Field Reference: the most important configuration fields
Prepare Boxes and Items: a prerequisite for meaningful packages
Tariffs and Shipping Costs: optional, for local shipping cost calculation
Next: Quick Start.


