ReturnlyUpdated a year ago
With the integration between Returnly and Gorgias, you'll have a seamless support experience by having your shoppers' return information available directly within Gorgias. This allows your team to stay focused and to answer shopper questions faster/with less effort by viewing the return status, refund status, and refund amount. Additionally, you have a direct link to a return for the shopper.
Setup instructions
Follow the below instructions to integrate Returnly with Gorgias:
- Click on the main menu (top left hand corner) and navigate to Settings > Integrations
- In the list select HTTP
- Click Add HTTP Integration
- In the integration detail page, enter the following information into the relevant fields:
Integration name | Returnly |
Description | Connected to Returnly for all your return information |
Triggers | ☑️ Ticket created ☑️ Ticket updated ☑️ Ticket message created |
URL | https://api.returnly.com/returns.json?include=return_line_items&shopper_email={{ticket.customer.email}} |
HTTP Method | GET |
Response type | application/json |
- Click Add header twice and enter the following information into the relevant fields:
Key | X-Api-Token | Value | your unique API Token from Returnly |
Key | X-Api-Version | Value | 2020-08 |
*Your unique API Token can be found in your Returnly account page here.
- Click Add integration
* If you're unsure of where to find your API token, please see here.
Your integration should look like this when you are complete:

After the integration has been set up, it will pull returns history for existing customers as well and not just for new customers' incoming returns.
How do I create the widget?
Once the above integration steps have been completed, you will need to create the widget. You can do this by creating a new support ticket for a test return or updating a support ticket for a test return.
After you have created a new ticket or updated an existing ticket, please follow these steps:
- Select the cog “Edit widgets” in the top right of the navigation bar.
- Scroll until you see “HTTP Data” on the right-hand navigation. For some users, the heading of “HTTP Data” does not appear, and instead just a red bar appears (see image below).
- Next, we will be configuring the widget. First, we will be removing duplicate or unreadable fields, and then configuring other fields to make them easier to consume.
Removing fields:
- Remove the entire “Links” section.
- Under "Header Data":
- Remove “Id”
- Remove “Type”
- Under "Attributes":
- Remove “Ext store id”
- Remove “RMA”
- Remove “Shopper email”
- Remove “Status"
- Remove “Relationship” section.
- Remove “Included” section.
Configuring fields:
- Update “Data”:
- Select the cog next to “Data” and then copy & paste the following into it:
- Title: “RMA {{id}} - {{attributes.status}}”
- Link: https://dashboard.returnly.com/dashboard/returns/{{id}}
- Click Submit.
- Select the cog next to “Data” and then copy & paste the following into it:
- Update “Attributes”:
- Select the cog next to “Attributes” and then copy & paste the following into it:
- Title: "Return Details" (or “RMA Details”)
- Click Submit.
- Select the cog next to “Attributes” and then copy & paste the following into it:
- Under the newly named "Return Details (or “RMA Details”):
- Click the “Created at” field and switch "Type" to “Date". Click Submit.
- Click the “Refunded at” field and switch "Type" to “Date". Click Submit.
- Click the “Updated at” field and switch "Type" to “Date”. Click Submit.
- Click Save changes.
You can reorder the fields in the widget to fit how your team will use them best by click and dragging them up and down the widget. The following is our suggested order, top to bottom:

FAQs
Where can I see information about Exchanges?
Currently, we don't have a way to present exchanges in Gorgias, but this is something that's planned for the future. To review an exchange associated with a return, you can select the link for the RMA and view the exchange order on the RMA details page (within Returnly)
How do I view a shipping label to resend it to the shopper?
You will need to select the RMA number link and view the RMA details page (within Returnly) to retrieve the shipping label for a shopper.