How to connect
SourceMedium connects to Loop Returns with an API key that you create in Loop and paste into SourceMedium.You connect data sources yourself in SourceMedium. Sign in to your SourceMedium account, open your store, then in the Data sources section click Connect data source and choose the platform. You need an Editor or Admin role on the store. If you have view-only access, ask an admin or editor on your team to connect it.Once it is connected, what happens next covers first-sync timing and what each connection status means.
1
Create an API key in Loop Returns
In Loop, go to Returns Management → Tools & integrations → Developer Tools and click Generate API key. Loop asks which scopes the key may use, and they come in
read and write variants per resource. Grant only the read scopes. See Loop’s guide: Authentication.2
Add the key in SourceMedium
Find Loop Returns in the connector picker and click Connect. Paste the API key and click Connect.
3
Confirm it is connected
SourceMedium checks the key with Loop before saving it, so a wrong key is rejected on the spot. The connection reads Awaiting first data until the first sync lands, then Connected.
SourceMedium only ever reads from your connected platforms. It does not create, change, or delete anything, so create the key with read-only access wherever the platform offers it. Treat it like a password: keep it confidential and avoid sharing it over email or in spreadsheets. If the credential is rotated or revoked, follow this guide’s connection method to update SourceMedium.
What data syncs
Data can include:- return outcome, such as exchange, refund, credit, upsell, or combined outcomes
- refunded, exchanged, and upsell amounts
- return timing
- return reasons
- returned SKUs and exchanged products
- links back to the original Shopify order and customer where available

