Integrations Overview | ReturnMate Help Centre

ReturnMate integrates with popular tools to streamline your returns workflow and keep your team connected. This overview covers available integrations and how to get started.

Available Integrations

Helpdesk Integrations

Integration	Status	Features
Gorgias	✓ Available	2-way sync, widget, ticket creation
Zendesk	✓ Available	Sidebar app, ticket linking, OAuth
Freshdesk	🔜 Coming Soon	View returns in tickets

E-commerce Platform

Integration	Status	Features
Shopify	✓ Native	Orders, customers, inventory sync

Carriers — Australia

Integration	Status	Features
Australia Post	✓ Available	Labels, tracking, pickup booking
StarTrack	✓ Available	Labels, tracking, pickup booking, DG
TNT (FedEx AU)	✓ Available	Labels, tracking, pickup booking, DG
TGE (Team Global Express)	✓ Available	Labels, tracking, pickup booking, DG
Mainfreight	✓ Available	Labels, tracking, pickup booking, DG

Carriers — New Zealand

Integration	Status	Features
NZ Post / CourierPost	✓ Available	Labels, tracking, pickup booking
Mainfreight NZ	✓ Available	Labels, tracking, DG

Carriers — North America & Global

Integration	Status	Features
FedEx	✓ Available	Labels, tracking, pickup booking (220+ countries)
UPS	✓ Available	Labels, tracking, pickup booking (220+ countries)
USPS	✓ Available	Labels, tracking (US domestic)
Canada Post	✓ Available	Labels, tracking (Canada domestic)

Marketing & CRM

Integration	Status	Features
Klaviyo	🔜 Planned	Segment customers by return behaviour

Gorgias Integration

Gorgias is a customer support platform designed for e-commerce. The ReturnMate integration provides:

Features

View Returns in Gorgias - See customer's return history in the sidebar
RMA Widget - Open full RMA details without leaving Gorgias
Status Sync - Return status updates appear in ticket timeline
Create RMAs - Initiate returns directly from a Gorgias ticket

Setup

Navigate to Settings → Integrations → Gorgias
Click Connect to Gorgias
Authorise the connection in Gorgias
Configure sync preferences

See Gorgias Integration for detailed setup instructions.

Zendesk Integration

The Zendesk integration is available now and lets you:

View customer returns in the Zendesk ticket sidebar app
Link tickets to RMAs and create tickets from RMAs
Sync customer messages and internal notes between systems

See Zendesk Integration for setup instructions, including OAuth and API-token connection options.

Freshdesk Integration

Coming Soon

The Freshdesk integration will provide:

Return history in Freshdesk contact view
RMA linking to support tickets
Status update synchronisation

Klaviyo Integration

Planned

Future Klaviyo integration will enable:

Customer segmentation by return behaviour
Return-triggered email flows
Sync return reasons to customer profiles

Webhooks

ReturnMate sends outbound webhooks for RMAs created through the External API (offline repairs and trade returns):

Available Events

Event family	Trigger
`offline_repair.*`	Offline repair created, tracking uploaded, status changed, disposition set, closed
`trade_return.*`	Trade return created, credit requested, resolved

Setting Up Webhooks

Go to Settings → External API
Create or edit an API client
Enter your endpoint in Webhook URL
Save — deliveries are signed with your client's webhook secret

Webhook Security

Deliveries include an X-Webhook-Signature HMAC header for verification. See Webhooks Reference for payloads, retries and verification code.

API Access

For developers, ReturnMate provides an External API for offline repairs and trade returns:

Capabilities

Create offline repair RMAs from an external system
Upload return tracking and drive the offline repair lifecycle
Create and retrieve trade (B2B) returns
Read RMA timelines

Authentication

API requests use an API key in the X-Api-Key header:

curl https://api.returnmate.io/api/v1/external/v1/offline-repairs \
  -H "X-Api-Key: rm_ext_YOUR_API_KEY"

API clients and keys are created in Settings → External API. See the API Reference for endpoints and payloads.

Integration Best Practices

Test integrations in a staging environment first
Monitor the RMA Activity Timeline for sync errors after linking tickets
Set up alerts for integration failures
Regularly review integration settings after updates

Troubleshooting Integrations

Connection Failed

If an integration won't connect:

Verify your account has the necessary permissions
Check that the third-party service is accessible
Review any error messages in the logs
Try disconnecting and reconnecting

Sync Delays

If data isn't syncing promptly:

Check the integration status page
Review sync logs for errors
Verify webhook endpoints are responding
Contact support if issues persist