Integrations Overview
Connect ReturnMate with your existing tools and systems.
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 | 🔜 Coming Soon | View returns in tickets |
| Freshdesk | 🔜 Coming Soon | View returns in tickets |
E-commerce Platform
| Integration | Status | Features |
|---|---|---|
| Shopify | ✓ Native | Orders, customers, inventory sync |
Carriers
| Integration | Status | Features |
|---|---|---|
| Australia Post | ✓ Available | Labels, tracking |
| StarTrack | ✓ Available | Labels, tracking |
| TNT | ✓ Available | Labels, tracking |
| TGE | ✓ Available | Labels, tracking |
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
Coming SoonThe Zendesk integration will allow you to:
- View customer returns in Zendesk ticket sidebar
- Link tickets to RMAs
- Add return updates to ticket timeline
Interested in Zendesk integration? Contact support@returnmate.io to join the waitlist.
Freshdesk Integration
Coming SoonThe Freshdesk integration will provide:
- Return history in Freshdesk contact view
- RMA linking to support tickets
- Status update synchronisation
Klaviyo Integration
PlannedFuture Klaviyo integration will enable:
- Customer segmentation by return behaviour
- Return-triggered email flows
- Sync return reasons to customer profiles
Webhooks
For custom integrations, ReturnMate provides webhooks:
Available Events
| Event | Trigger |
|---|---|
rma.created | New RMA submitted |
rma.updated | RMA status changed |
rma.received | Package received at warehouse |
rma.completed | Return fully processed |
refund.processed | Refund issued |
Setting Up Webhooks
- Go to Settings → Integrations → Webhooks
- Click Add Webhook
- Enter your endpoint URL
- Select events to subscribe
- Save and test
Webhooks include a signature header for verification. See Webhooks & Reliability for implementation details.
API Access
For developers, ReturnMate provides a REST API:
Capabilities
- Create and manage RMAs
- Retrieve order and customer data
- Generate shipping labels
- Update return statuses
- Access reporting data
Authentication
API requests use bearer token authentication:
curl -X GET https://api.returnmate.io/v1/rmas \
-H "Authorization: Bearer YOUR_API_TOKEN"
API documentation available upon request. Contact support@returnmate.io for access.
Integration Best Practices
- Test integrations in a staging environment first
- Monitor for sync errors in Settings → Integrations → Logs
- 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