---
title: "ShipHero for Gladly AI"
slug: "shiphero-for-sidekick"
updated: 2026-04-03T20:49:57Z
published: 2026-04-03T20:49:57Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gladly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ShipHero for Gladly AI

This Documentation is for a Gladly AI Integration

This documentation is for an integration used by Gladly AI. Apps like this will soon also be able to display data and provide actions that interact with external systems and products within Agent-facing Customer Profiles. However, if you are looking for this capability now, you may be more interested in [our list of integrations for Gladly Team](https://help.gladly.com/docs/list-of-app-integration-partners).

### Who maintains the integration

The Shiphero for Gladly AI integration is built and maintained by Gladly.

## Benefits

**Quick Resolutions**

Customers can access information instantly without contacting an Agent, improving satisfaction.

**Optimized Agent Productivity**

Agents can focus on high-value tasks that require their expertise rather than handling routine inquiries.

**24/7 Availability**

Customers can get answers anytime, even outside business hours, enhancing convenience and accessibility.

## Available Actions

- 
  - **Lookup Order by Order Number**
  - **Detailed Order Data**

Orders returned from ShipHero can contain:

    - id
    - order number
    - partner order id
    - total tax (currency)
    - total discounts (currency)
    - subtotal
    - total price
    - order date
    - updated at datetime
    - email
    - account id
    - shipping lines:
      - carrier
      - method
      - price
      - title
    - shipping address
    - billing address
    - tags
    - line items:
      - id
      - quantity
      - product name
      - sku
      - fulfillment status
      - product details: id, name, tags
    - holds: address, client, fraud, operator, payment, or shipping method holds
    - currency
    - hold-until date
    - tax id
    - tax type
- **Lookup Orders by Email Address**
  - Returns a list of orders, including the detailed order data above
- **Track Shipments by Order ID**
  - Returns a list of shipments
  - **Detailed Shipment Data**

Shipments returned from ShipHero can contain:

    - id
    - order id
    - user id
    - warehouse id
    - pending shipment id
    - picked up status
    - needs refund status
    - refunded status
    - delivered status
    - address
    - created date
    - line items:
      - id
      - shipment id
      - shipping label id
      - line item id
      - quantity
    - shipping labels:
      - id
      - account id
      - box id
      - carrier
      - carrier account id
      - created date
      - delivered status
      - full size to print
      - insurance amount
      - needs refund status
      - order account id
      - order id
      - order number
      - packing slip
      - partner fulfillment id
      - picked up status
      - refunded status
      - shipment id
      - shipping method
      - shipping name
      - source
      - status
      - tracking number
      - tracking url
      - warehouse
      - warehouse id

> [!NOTE]
> Technical Documentation Available!
> 
> Technical Documentation, as well as an extensible version of this App are available on [GitHub](https://github.com/gladly/app-platform-examples/tree/main/shiphero).

## Example Use Cases

- Answer WISMO (Where Is My Order) questions, such as:
  - "What happened to my order?" (e.g., details about an attempted delivery yesterday)
  - "Did I send it to the right address?" (e.g., verifying the shipping address).
- Estimate delivery times
  - Look up a Customer’s order, find the corresponding shipment, and check the shipping status and date information from the associated shipping label to estimate a delivery date based on historical data.

## Setup & Installation

### Before You Start

1. You will need to obtain a GraphQL API Access & Refresh Token as described [here](https://software-help.shiphero.com/hc/en-us/articles/4419362224781-How-to-Obtain-a-GraphQL-API-Access-Refresh-Token).
2. For “Developer Details” put: Name: Gladly Last Name: Inc Email: integrations@gladly.com ![](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/Screenshot 2025-07-23 at 16.49.13.png)
3. Click “Add Developer”
4. Make a note of the “Access Token” and “Refresh Token” ![Access and refresh tokens displayed with instructions for developers to note them.](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/Screenshot 2025-07-23 at 16.53.45.png)
5. Contact Gladly Support, and request that the Shiphero for Gladly AI App be installed in your Gladly instance. You will need to provide the Access Token you generated, **using a secure password sharing service** like [One Time Secret](https://onetimesecret.com/).