> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dema.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ingrid

> Let the Dema Agent read orders, returns, and refunds, report returned items, and mark refunds as externally refunded in Ingrid when you ask.

## 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.

<Note>
  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).
</Note>

***

## Connect Ingrid

<Steps>
  <Step title="Create an API key in the Returns backoffice">
    1. Sign in to the Returns backoffice at [returns-portal.ingrid.com](https://returns-portal.ingrid.com).
    2. Go to **Settings → API Keys** ([returns-portal.ingrid.com/settings/api-keys](https://returns-portal.ingrid.com/settings/api-keys)).
    3. Generate a key and copy it. Use your **production** key — Dema connects to Ingrid's production environment.

    <Note>
      Keys differ between stage and production. If you do not have access to the Returns backoffice, contact [support@ingrid.com](mailto:support@ingrid.com).
    </Note>
  </Step>

  <Step title="Connect in Dema">
    In Dema, go to **Agents → Settings → Integrations**, find **Ingrid**, and click **Connect**. Enter:

    * **API key** — the production Returns API key you copied.

    Click **Add**. Dema marks the integration as Active.
  </Step>
</Steps>

***

## 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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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](mailto:support@ingrid.com).
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

If you are still stuck, contact [support](mailto:info@dema.ai) with the error message you see.

***

## Additional resources

* [Ingrid Returns Public API](https://developer.ingrid.com/returns/api/)
* [Ingrid API keys (support)](https://support.ingrid.com/your-api-keys)