Connect ReturnEase to your existing tools for an automated and transparent workflow
Choose an integration to see the complete setup guide and best practices
Create and manage API keys to connect ReturnEase to your tools and custom automations
Learn More →Connect ReturnEase to more than 5,000 applications without code via Zapier to automate your workflow
Learn More →Install our official WooCommerce plugin to automatically synchronize returns with your store
Learn More →webhooks allow you to automatically receive return data in your existing systems in real time.
A webhook is an automatic notification sent from ReturnEase to your system when an event product (like a new return). It's like a push notification for your software.
Here's how merchants use ReturnEase webhooks:
Automatically create support tickets for each return.
Example : Zendesk, Freshdesk, Help Scout, Intercom
Track customer returns in your CRM for a complete customer view.
Example : Salesforce, HubSpot, Pipedrive, Monday.com
Automatically update stock levels when a return is processed.
Example : Custom inventory systems, ERP, WMS
Send return notifications to Slack, Teams or other communication tools.
Example : Slack, Microsoft Teams, Discord, Telegram
Configure A webhook in a few minutes:
Configure a URL on your server that can receive POST requests. Your endpoint must accept JSON and respond with a 200 OK status code.
https://yoursite.com/api/webhooks/returneaseGo to your ReturnEase dashboard and add your webhook URL in the integration settings.
Open integrations →Submit a test return and verify your endpoint receives the data correctly.
Once tested, your webhook is operational! You will now automatically receive notifications for all new returns.
Here's an example of JSON data that ReturnEase will send to your webhook:
{
"event": "return.created",
"return_id": "ret_abc123",
"return_number": "RET-2025-0001",
"type": "return",
"customer": {
"name": "Jean Dupont",
"email": "jean@example.com",
"phone": "+33612345678",
"address": "123 Rue de Paris, 75001 Paris"
},
"order": {
"order_number": "ORD-12345",
"order_date": "2025-01-15"
},
"reason": "Produit ne correspond pas à la description",
"description": "La couleur ne correspond pas...",
"photos": [
"https://cdn.returnease.eu/photos/abc123.jpg"
],
"created_at": "2025-10-16T14:30:00Z",
"merchant_id": "mer_xyz789"
}Note: all timestamps are in UTC ISO 8601 format. Photos are pre-signed URLs valid for 24 hours.
your webhook URL does not exist or is not accessible.
Solution : Check that your webhook URL is correct and that your server is online. Test the URL in your browser.
your server encounters an error when processing the webhook.
Solution : Check your server logs for the errors. Make sure your endpoint can process the JSON format we send.
your server does not respond quickly enough (timeout after 5 seconds).
Solution : Optimize your endpoint to respond quickly. Process data asynchronously if necessary.
your SSL certificate is not valid or has expired.
Solution : Make sure your webhook URL uses HTTPS with a valid SSL certificate from Let's Encrypt or another trusted authority.
You can see all webhook delivery attempts, response codes and errors in your dashboard.
View webhook logs →Respond quickly with 200 OK - process data asynchronously if necessary
Implement retry handling - ReturnEase will retry up to 3 times in case of failure
Log webhook payloads for debugging and auditing
Use HTTPS with a valid SSL certificate for security
Monitor your webhook logs to detect issues quickly
Connect ReturnEase to your existing tools in a few minutes
Configure webhooks