8returns is a returns management platform that helps merchants automate return registration, label generation, inspection, and refunds through a branded customer returns portal.

With the 8returns integration, return events sync automatically to Omnisend, allowing you to trigger targeted email and SMS automations whenever a customer registers or updates a return.

Benefits

Real-time return triggers: Respond the moment a customer registers a return, or when its status changes (label created, arrived, inspected, refunded, canceled).
Order and refund context: Each event includes the original order reference, refund amount, and currency, and full item-level detail.
Automated customer communication: Keep customers informed about their return through Automation Workflows.

Setup Process

Step 1. In Omnisend, go to Apps → search for the 8returns app → click Connect now.

Step 2. You'll be asked for your 8returns API Key and Password. You can find (or generate) these in your 8returns dashboard under Settings → Integrations → API.

Step 3. Paste your API Key and Password into Omnisend and click Connect.

That's it - Omnisend automatically registers the required webhooks with your 8returns account. All enabled 8returns return lifecycle events will now be triggered as custom events in Omnisend.

What Data is Passed

Contact Fields in Contact Profiles

The following fields will be added to the contact profile in Omnisend:

Email address
Country

Supported Custom Events

Custom Event Name	Description
`8returns - Return Registered`	Triggered when a customer registers a new return
`8returns - Label Created`	Triggered when a return shipping label is created
`8returns - Return Arrived`	Triggered when the returned item arrives at the return location
`8returns - Return Inspected`	Triggered when the returned item has been inspected
`8returns - Return Refunded`	Triggered when the return is completed and refunded
`8returns - Return Cancelled`	Triggered when the return is canceled

Note: It may take a few minutes for a return event in 8returns to appear as a custom event in Omnisend. This is normal and does not indicate an issue with the integration.

Event Properties

Each event includes return data as event properties, including:

Property	Description
`order_number`	Original order number
`order_name`	Original order name (e.g. `RE1550`)
`total_amount`	Total return amount and currency
`status`	Current return status (e.g. `registered`, `received`, `needs_review`, `completed`, `cancelled`)
`tracking_number`	Shipment tracking number, once a label has been created
`label_url`	URL of the generated return shipping label
`qrcode_url`	URL of the generated return QR code
`shipping_company`	Carrier used for the return shipment (e.g. `dhl`)
`total_refund_amount`	Final refund amount issued to the customer (present on refunded events)
`return_fees`	Any return fees deducted from the refund (present on refunded events)
`items`	Full array of returned items, including SKU, name, quantity, return reason, condition, and per-item status

💬 Learn more: Use Personalization in Omnisend.

Build Automation Workflows with 8returns Events

Here are some automations you can build once the data is flowing:

Return confirmation email: When 8returns - Return Registered fires, confirm receipt of the customer's return request and let them know what to expect next.
Label ready notification: When 8returns - Label Created fires, send the customer their shipping label and tracking number.
Return received update: When 8returns - Return Arrived fires, let the customer know their return has arrived and is being processed.
Refund processed notification: When 8returns - Return Refunded fires, confirm the refund amount issued.
Cancellation follow-up: When 8returns - Return Cancelled fires, let the customer know their return request was canceled.

💬 Learn more: Set Up Automation Workflow Settings.

FAQ

Which 8returns plan do I need?

You need an 8returns account with API access under Settings → Integrations → API. Contact 8returns support to confirm availability for your plan.

Does this integration support order tracking events?

Not currently. This integration currently covers only return lifecycle events.

What subscription status will new contacts have?

New contacts created through this integration are set up based on the provided identifiers. They will not receive marketing emails until they opt in through Omnisend's subscription forms, unless they were already subscribed.

Does historical data sync?

No, only real-time events from the moment the integration is activated.

Can I use 8returns events in Email Campaigns?

8returns events are designed for Automation workflows. To send one-time campaigns, create a segment based on contact data synced from 8returns events and send a campaign to that segment.

If you couldn't find the answer to your question, reach out to our Support Team through the in-app chat or at [email protected] - our team is available 24/7.

Integrate 8returns with Omnisend