Gorgias Integration Setup and Troubleshooting
Connect SHIPAID to Gorgias so your support team can view existing shipment Issues and apply available resolutions from the ticket sidebar. Your team stays in control of each decision and your store’s resolution policy.
Before you start
- An active SHIPAID account with your Shopify store connected.
- A Gorgias account with the same Shopify store connected.
- A Gorgias administrator who can install and manage apps, plus access to the correct store in SHIPAID.
- For Store Credit, Discount, or Gift Card actions, the corresponding resolution option must be enabled in SHIPAID.
This integration works with Shopify shipment Issues. It does not create Issues or manage return requests from Gorgias.
1. Install SHIPAID in Gorgias
- Sign in to the Gorgias helpdesk you want to connect.
- Open Settings → Apps → App Store, search for ShipAid, and open the app. You can also start from ShipAid’s Gorgias App Store listing. Older Gorgias screens may call the app directory All Apps.
- Select the app’s connect or install button. If prompted, choose the intended Gorgias account.
- Review the requested permissions and select Authorize App to complete the connection.
- When installation finishes, return to Gorgias’s integration settings. SHIPAID creates its integration and sidebar widgets automatically; you do not need to enter API keys or build an HTTP integration manually.
You can also find the marketplace link in SHIPAID under Settings → Integrations → Partner Integrations → Customer Service Tools → Gorgias.
2. Confirm the connection
- Choose an existing, unresolved Issue in SHIPAID and note its order number and customer email.
- Open a Gorgias ticket for that same customer email. Expand the right-hand sidebar and refresh the ticket if needed.
- Look for a card titled ShipAid Issue [number]. Confirm that its Issue number, order number, customer details, and status match SHIPAID.
- Select the Issue link to open the full record in SHIPAID.
Verification path: Gorgias ticket → right sidebar → ShipAid Issue [number] → matching order and status.
Viewing the card is enough to check the connection. Resolution buttons perform real actions; use them only when you intend to resolve the customer’s Issue.
An owner or administrator can inspect the generated connection under Settings → Account → HTTP integration → Manage → ShipAid. The Events tab helps identify unsuccessful integration requests.
3. Configure available resolutions
In SHIPAID, open Settings → Resolution → Resolutions. Enable the options your team is allowed to offer and select Save. For Store Credit, Discount, or Gift Card, check both the main Enable Store Credit setting and the matching choice under Store Credit Options.
Keep your normal store policy and agent permissions in place. The integration does not decide whether an Issue should be approved or denied.
4. Use SHIPAID in a Gorgias ticket
The Issue card can show the Issue and order numbers, dates, tracking link, reason, items, Issue total, guarantee information, customer details, and status. A tracking link may show N/A when no tracking identifier is available.
- Open the customer’s ticket and review the matching Issue card.
- Choose the appropriate available action: Refund, Reorder, Store Credit, Discount, Gift Card, Deny, or Other.
- Where the form asks for items, select All. Individual-item or partial resolutions are not supported in this widget; handle those in SHIPAID.
- Complete any amount and note fields. Set Notify Customer to YES or NO as appropriate.
- Review the action, then submit once. A successful action returns Resolution applied successfully. Check the Issue in SHIPAID before retrying an uncertain result.
After an Issue is resolved, its actionable widget may disappear. It can reappear when that customer has a new eligible Issue. The same Issue cannot be resolved a second time.
Troubleshooting
Authorization fails or installation cannot find my store
Confirm that you are a Gorgias administrator, that you authorized the intended helpdesk, and that the same Shopify store is already connected to both Gorgias and SHIPAID. Complete any interrupted authorization screen. If the browser blocked the authorization window, allow that window and retry the setup.
The Issue widget is missing or empty
Confirm that an Issue already exists in SHIPAID, that it belongs to the connected Shopify store, and that the Gorgias ticket’s customer email matches the Issue customer email. Refresh the ticket and expand the sidebar. An ordinary order without an Issue will not produce an Issue card. A resolved Issue’s actionable widget can disappear as expected.
A resolution is unavailable or fails
Confirm that the Issue is still unresolved, select All rather than individual items, and check that the desired resolution is enabled in SHIPAID. For credit-related actions, select the matching Store Credit Option and save. If the result is unclear, inspect the Issue in SHIPAID before trying the action again.
The integration reports a request error
Ask a Gorgias owner or administrator to open Settings → Account → HTTP integration → Manage → ShipAid → Events. Note the failed request’s time and error. Confirm that the underlying Shopify connection is active in both products, then contact SHIPAID if the error continues.
I use several Shopify stores or need to change helpdesks
Verify each store’s connection separately. Do not assume one installation covers every Shopify store in a Gorgias account. Reconnecting can replace the existing SHIPAID widgets, so contact SHIPAID before changing the connected store or combining multiple stores in one helpdesk.
Disconnect or reconnect
To remove the app, a Gorgias administrator can open Settings → Apps → Installed Apps → ShipAid → Delete app and confirm. To reconnect, follow the installation steps above. For multiple stores, coordinate with SHIPAID first.
Do not use SHIPAID’s Disconnect Store control for this task; that disconnects the Shopify store itself.
Need help?
Email support@shipaid.com or use chat at help.shipaid.com. Include your Shopify store domain, Gorgias account subdomain, affected Issue number, the step that failed, and the error wording.
Last reviewed: October 19, 2026.
Updated on: 19/10/2026
Thank you!
