---
title: Integration With Shippo
description: "ReturnGO integrates with Shippo to help you manage your returns shipping. \nShippo is a shipping aggregator that connects you to a wide range of carriers for automating return shipping labels to save you time and money."
---

[Skip to content](https://support.returngo.ai/integration-with-shippo#main-content)

English

Show submenu for translations

[Customer portal](https://support.returngo.ai/tickets-view?hsLang=en)

![ReturnGO Logo-1](https://support.returngo.ai/hs-fs/hubfs/ReturnGO%20Logo-1.png?width=198&height=30&name=ReturnGO%20Logo-1.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Customer portal](https://support.returngo.ai/tickets-view)
- Go to returngo.ai

 Go to returngo.ai

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge Base](https://support.returngo.ai/?hsLang=en)
2. [Shipping Integrations](https://support.returngo.ai/shipping-integrations?hsLang=en)
3. [Shipping Aggregators](https://support.returngo.ai/shipping-integrations?hsLang=en#shipping-aggregators)

# Integration With Shippo

Last Updated: April 29, 2026

ReturnGO integrates with Shippo to help you manage your returns shipping. 

[**Shippo**](https://goshippo.com/)is a shipping aggregator that connects you to a wide range of carriers for automating return shipping labels to save you time and money. 

For the best experience, it’s recommended to use [**Ship by ReturnGO**](https://support.returngo.ai/ship-by-returngo?hsLang=en), ReturnGO’s built-in shipping solution. Ship by ReturnGO is available on all plans and needs no integration.

### Capabilities

The ReturnGO-Shippo integration supports: 

- Pay-on-scan return labels 
- QR code generation through supported carriers: 
    - Evri - for both forward and return labels.
    - USPS - only for forward labels, and only for supported services. Unsupported modes will result in an error.
- Live tracking status updates 
- Auto-select-cheapest 

| **Return Labels** | **Return Tracking** | **QR Codes** | **Auto Select Cheapest** | **International Shipping** |
| --- | --- | --- | --- | --- |
| ![](https://support.returngo.ai/hubfs/Icon%20(34)-png.png) | ![](https://support.returngo.ai/hubfs/Icon%20(34)-png.png) | ![](https://support.returngo.ai/hubfs/Icon%20(36)-png.png) | ![](https://support.returngo.ai/hubfs/Icon%20(34)-png.png) | ![](https://support.returngo.ai/hubfs/Icon%20(34)-png.png) |

See a full feature**[comparison with other shipping carriers](https://returngo.ai/shipping-integrations-comparison/).**

### Requirements

To link your Shippo account to ReturnGO, you will need: 

- **A Premium plan or higher**
- **Shippo Account** 
    - Make sure you have a Shippo web app account.
- **Shippo API token ** 
    - Log in to [**Shippo \> Settings \> API**](https://app.goshippo.com/settings/api) to generate a live API token.
- **Shippo API (Latest Version) ** 
    - Log in to [**Shippo \> Settings \> API**](https://app.goshippo.com/settings/api) to verify or upgrade your Shippo API version.
    - In some cases, using an older Shippo API version can prevent label creation. 

![Shippo API](https://support.returngo.ai/hs-fs/hubfs/Shippo%20API.png?width=670&height=369&name=Shippo%20API.png)

- **Valid Payment Method ** 
    - A valid payment method must be registered in your Shippo account. 
    - Log in to [**Shippo \> Settings \> Account \> Billing**](https://apps.goshippo.com/settings/account/billing) to set up a payment method in Shippo. 

When choosing a carrier, it should be configured to support return labels. 

- Otherwise, the carrier may show up in your shipping account but will not be listed as a carrier option in ReturnGO.  

### Linking your Shippo Account to ReturnGO 

To link your Shippo account to ReturnGO: 

1. Go to**[Settings \> Integrations.](https://app.returngo.ai/dashboard/settings/integrations/products-services)**
2. Click on **ADD PRODUCT OR SERVICE. **
3. Choose **Shippo** from the drop-down list. 
4. Click on the green check mark.  
   ![Shippo Integration 1](https://support.returngo.ai/hs-fs/hubfs/Shippo%20Integration%201.png?width=670&height=333&name=Shippo%20Integration%201.png)
5. Enter your credentials.
6. Click **CONNECT. **

**![Shippo Integration 2](https://support.returngo.ai/hs-fs/hubfs/Shippo%20Integration%202.png?width=670&height=418&name=Shippo%20Integration%202.png)**

### Adding the Integration to a Return Method

Once you've connected the integration, you'll need to add it to a return method:

1. Go to [**Settings \> Return Methods.**](https://app.returngo.ai/dashboard/settings/return-methods) 
2. Open the *Ship with pre-paid label* section. 
3. Click **ADD RETURN METHOD** or select a return method to edit.  
   ![Shippo Integration 3](https://support.returngo.ai/hs-fs/hubfs/Shippo%20Integration%203.png?width=624&height=309&name=Shippo%20Integration%203.png)
4. Open the *Shipping Label Settings* section.
5. Set *Connection* to **Shippo**.
6. Select a carrier/service level.  
   ![Shippo Integration 4](https://support.returngo.ai/hs-fs/hubfs/Shippo%20Integration%204.png?width=670&height=340&name=Shippo%20Integration%204.png)
7. Set the Dangerous Goods Type, such as:

- Not Dangerous
- Other
- Lithium Batteries
- Biological Materials

![Shippo Integration 5](https://support.returngo.ai/hs-fs/hubfs/Shippo%20Integration%205.png?width=670&height=130&name=Shippo%20Integration%205.png)

**Note:** Please select the correct option. Dangerous goods information is required for some carriers, such as USPS. ReturnGO does not validate whether the selected dangerous goods type meets the carrier’s requirements, which may vary by domestic or international shipment and hazardous material type.

8\. Verify your return address and shipping instructions.

9\. Click on the *save* icon to save your changes.  
![Shippo Integration 6](https://support.returngo.ai/hs-fs/hubfs/Shippo%20Integration%206.png?width=670&height=390&name=Shippo%20Integration%206.png)

**Note:** You can choose to disable the shipping address validation that Shippo performs when a shipment is created, by enabling the toggle under **Return Methods \> Shipping Label Settings**.

### Troubleshooting the Integration

Many of the issues encountered related to integration can be identified during setup or label generation. 

Here are a few things you can check to try and fix such issues: 

#### **Setup Issues**

**Make sure your API credentials are accurate. **

- There should be no extra spaces before or after each API entry. 
- Make sure you are using live or production API credentials, and not dev or test APIs. 
- Try to re-generate a new API key and reconnect. 
- If a carrier or service level is not available, contact your shipping service support team to verify which return services are available. 

**Note:** Some carriers support forward deliveries only, returns only, or both.

#### **Label Creation Issues**

**Verify your Return Address**

- Some carriers require that the return address be registered or linked to your carrier account.
- If the address is not associated with your shipping account, the label may fail to generate and display an error such as *No shipping locations found.*
- Some carriers may not recognize special characters, which might cause issues when generating labels. 
- Remove special characters and unnecessary spaces in your return address.  
    - For example:  
          - If your store name is “John & Jane Store”, change it to “John and Jane Store”. 
          - If your store phone number has “+” signs or “( )”, remove them. 

**Verify the Customer's Address **

- ReturnGO collects the order's shipping address when the request is submitted.
- If there are corrections to the customer’s address, reject and resubmit the return request. 

**Verify the Item Weight **

- If the total weight of the items being returned exceeds the service level’s weight limit, then the carrier will reject the label request. 

**Verify if you can Generate a Return Label for the Order Directly in the Shipping Platform**

- If your shipping service platform cannot generate the label, then it will also fail in ReturnGO. 

#### **Shippo-Related Issues** 

For Shippo-related issues, please contact Shippo support. 

- See the [**Shippo \> Contact**](https://goshippo.com/contact/) page. 

#### **Other Issues** 

For any other issues, feel free to contact [**ReturnGO Support**](https://support.returngo.ai/contacting-returngo-support?hsLang=en) through chat or [**email**](mailto:support@returngo.ai)**.** 

- [Account & Setup](https://support.returngo.ai/account-setup?hsLang=en#main-content)

    - [Getting Started](https://support.returngo.ai/account-setup?hsLang=en#getting-started)
    - [Installing ReturnGO](https://support.returngo.ai/account-setup?hsLang=en#installing-returngo)
    - [Account Settings](https://support.returngo.ai/account-setup?hsLang=en#account-settings)
    - [Billing](https://support.returngo.ai/account-setup?hsLang=en#billing)
    - [Portal Customization](https://support.returngo.ai/account-setup?hsLang=en#portal-customization)
    - [Emails](https://support.returngo.ai/account-setup?hsLang=en#emails)
    - [FAQs](https://support.returngo.ai/account-setup?hsLang=en#faqs)
- [Returns Management](https://support.returngo.ai/returns-management?hsLang=en#main-content)

    - [Processing Returns](https://support.returngo.ai/returns-management?hsLang=en#processing-returns)
    - [Return Portals](https://support.returngo.ai/returns-management?hsLang=en#return-portals)
    - [Advanced Returns Management](https://support.returngo.ai/returns-management?hsLang=en#advanced-returns-management)
    - [Return Methods](https://support.returngo.ai/returns-management?hsLang=en#return-methods)
    - [Return Policy](https://support.returngo.ai/returns-management?hsLang=en#return-policy)
    - [Automation](https://support.returngo.ai/returns-management?hsLang=en#automation)
    - [Inventory](https://support.returngo.ai/returns-management?hsLang=en#inventory)
    - [Return Reasons](https://support.returngo.ai/returns-management?hsLang=en#return-reasons)
    - [Warranty Management](https://support.returngo.ai/returns-management?hsLang=en#warranty-management)
- [Return Resolutions](https://support.returngo.ai/return-resolutions?hsLang=en#main-content)

    - [Refunds](https://support.returngo.ai/return-resolutions?hsLang=en#refunds)
    - [Exchanges](https://support.returngo.ai/return-resolutions?hsLang=en#exchanges)
    - [Other Resolutions](https://support.returngo.ai/return-resolutions?hsLang=en#other-resolutions)
- [Return Shipping](https://support.returngo.ai/return-shipping?hsLang=en#main-content)

    - [Ship by ReturnGO](https://support.returngo.ai/return-shipping?hsLang=en#ship-by-returngo)
    - [Shipping Labels](https://support.returngo.ai/return-shipping?hsLang=en#shipping-labels)
    - [Shipping Settings](https://support.returngo.ai/return-shipping?hsLang=en#shipping-settings)
    - [QR Codes](https://support.returngo.ai/return-shipping?hsLang=en#qr-codes)
- [Shipping Integrations](https://support.returngo.ai/shipping-integrations?hsLang=en#main-content)

    - [Shipping Integrations](https://support.returngo.ai/shipping-integrations?hsLang=en#shipping-integrations)
    - [Shipping Aggregators](https://support.returngo.ai/shipping-integrations?hsLang=en#shipping-aggregators)
    - [Shipping Carriers](https://support.returngo.ai/shipping-integrations?hsLang=en#shipping-carriers)
    - [Drop-Off Services](https://support.returngo.ai/shipping-integrations?hsLang=en#drop-off-services)
- [Other Integrations](https://support.returngo.ai/other-integrations?hsLang=en#main-content)

    - [Helpdesk Integrations](https://support.returngo.ai/other-integrations?hsLang=en#helpdesk-integrations)
    - [3PL/WMS Integrations](https://support.returngo.ai/other-integrations?hsLang=en#3pl-wms-integrations)
    - [Fintech Integrations](https://support.returngo.ai/other-integrations?hsLang=en#fintech-integrations)
    - [Loyalty Integrations](https://support.returngo.ai/other-integrations?hsLang=en#loyalty-integrations)
    - [Marketing Integrations](https://support.returngo.ai/other-integrations?hsLang=en#marketing-integrations)
    - [ERP Integrations](https://support.returngo.ai/other-integrations?hsLang=en#erp-integrations)
    - [ReturnGO API](https://support.returngo.ai/other-integrations?hsLang=en#returngo-api)
- [Order Tracking](https://support.returngo.ai/order-tracking?hsLang=en#main-content)

    - [Order Tracking Portal](https://support.returngo.ai/order-tracking?hsLang=en#order-tracking-portal)
    - [Order Tracking Notifications](https://support.returngo.ai/order-tracking?hsLang=en#order-tracking-notifications)
- [Analytics](https://support.returngo.ai/analytics?hsLang=en#main-content)

    - [Analytics](https://support.returngo.ai/analytics?hsLang=en#analytics)
    - [Reports](https://support.returngo.ai/analytics?hsLang=en#reports)
- [Legacy Features](https://support.returngo.ai/legacy-features?hsLang=en)

[![Chill listening crop-3](https://support.returngo.ai/hs-fs/hubfs/RETURNGO%20BLUE.png?width=162&height=24&name=RETURNGO%20BLUE.png "Chill listening crop-3")](https://returngo.ai)

knowledge Base

Copyright © 2026, ReturnGO