Overview
Once Ingrid is connected, the Dema Agent can work with your Ingrid returns data directly inside a conversation — retrieve orders, returns, and refund transactions, report returned items, and mark refunds as externally refunded — via the Ingrid Returns Public API. The agent only acts when you ask it to, and Dema asks you to confirm sensitive changes before they are applied.Prerequisites
- An Ingrid Returns account with access to the Returns backoffice (the Merchant Returns Platform).
- A production Returns API key.
Ingrid has more than one kind of API key. Dema needs the Returns API key created in the Returns backoffice — not the key in the main Ingrid Merchant Platform (that one is for Checkout, Tracking, and Transport Automation).
Connect Ingrid
Create an API key in the Returns backoffice
- Sign in to the Returns backoffice at returns-portal.ingrid.com.
- Go to Settings → API Keys (returns-portal.ingrid.com/settings/api-keys).
- Generate a key and copy it. Use your production key — Dema connects to Ingrid’s production environment.
Keys differ between stage and production. If you do not have access to the Returns backoffice, contact support@ingrid.com.
Rotating the key
To rotate, generate a new key under Settings → API Keys in the Returns backoffice, click Reconnect on the Ingrid integration card in Dema, and enter the new key.Troubleshooting
Dema cannot authenticate
Dema cannot authenticate
Make sure you used the production Returns API key from the Returns backoffice (
returns-portal.ingrid.com/settings/api-keys), not a stage key and not a key from the main Ingrid Merchant Platform.I cannot find the API Keys page
I cannot find the API Keys page
You need access to the Returns backoffice. If you cannot reach Settings → API Keys, contact support@ingrid.com.
Ingrid's docs show turnr.se URLs
Ingrid's docs show turnr.se URLs
turnr.se is Ingrid’s legacy domain — Ingrid acquired Turnr and migrated the Returns service to ingrid.com. It is the same service; you do not need to do anything.