ShipHub Authentication

Version	Created by	Date	Notes
1.0	Danail Deltchev	06/17/2025	First Publish

The purpose of this page is to explain how to authenticate and handle ShipHub integration and creds

API endpoint: /login

Method: POST

Parameters:

username
password
account_number

Example:

curl --location 'https://sandbox.shipping.run/partners/login' \
--form 'username="test"' \
--form 'password="test"' \
--form 'account_number="111111"'

Setup should be taken from Courier Service Providers where we should have a dropdown with all working integrations. In this case we need to have ShipHub which will point us to the fields we need filled in - in this case the parameters:

Username - plain text
Password - password protected field
Account number - plain text

Mapping of parameters is self explanatory 🙂

Successful Response should return an AccessToken which is to be used on every other call and the Expiration time in ExpiresIn

Success response example:

{
    "status": 200,
    "data": {
        "AccessToken": "qwieuo12iu3o1j2ej12iej...",
        "ExpiresIn": 1200,
        "TokenType": "Bearer"
    }
}

Error response example:

{
    "status": 401,
    "message": "Login Failed. Please check your username, password, account_number or contact support."
}

Shipping label improvements / ShipHub Integration / ShipHub Authentication

ShipHub Authentication